Loading...

tools / mobile-network-debug

Mobile Network Debug Checklist

Turn device proxy, Chucker, OkHttp, Charles, Proxyman, and API failure notes into a repeatable mobile network debugging plan.

P1Mobile DebuggingHigh severity
100
debug signal score
4 signals

4 signals detected. Start with tls or certificate failure.

Detected signals

TLS or certificate failure

The mobile client is rejecting TLS or proxy certificates.

Install the proxy CA, check network security config, and account for certificate pinning.

Cleartext traffic blocked

Android is blocking non-HTTPS traffic.

Use HTTPS or explicitly allow debug-only cleartext domains in network security config.

Mobile API auth failure

The mobile request is failing auth.

Compare mobile headers, token audience, refresh timing, and environment base URL with a working client.

Proxy capture issue

Network capture tooling is part of the investigation.

Verify device proxy, emulator host mapping, VPN, trust store, and app debug build settings.

Highlighted lines
line 1
OkHttp 401 /v1/profile
Mobile API auth failure
line 2
javax.net.ssl.SSLHandshakeException
TLS or certificate failure
line 3
CLEARTEXT communication not permitted
Cleartext traffic blocked
line 4
Charles proxy no traffic on Android emulator
Proxy capture issue
Fix checklist
Install the proxy CA, check network security config, and account for certificate pinning.
Use HTTPS or explicitly allow debug-only cleartext domains in network security config.
Compare mobile headers, token audience, refresh timing, and environment base URL with a working client.
Verify device proxy, emulator host mapping, VPN, trust store, and app debug build settings.
Confirm device/emulator, OS version, app build, base URL, and proxy state.
Capture request headers without secrets.
Compare with cURL or API Workbench.

DebugTools product

Mobile Network Debug Checklist

Mobile Network Debug Checklist is a focused DebugTools mini-product for developers. Turn device proxy, Chucker, OkHttp, Charles, Proxyman, and API failure notes into a repeatable mobile network debugging plan.

Use cases

  • Review mobile logs, crashes, startup, network, and device-specific clues.
  • Separate JavaScript, native, runtime, and platform evidence.
  • Capture a focused debugging report for mobile issue triage.

How it works

  • Paste or load the snippet you want to inspect in Mobile Network Debug Checklist.
  • Run the tool in the browser and review the highlighted output.
  • Copy, export, or turn the result into the next debugging step.

Privacy

  • Mobile Network Debug Checklist is local-first. The core workflow runs in your browser and does not require sending pasted content to DebugTools servers.

This tool history

Recent Mobile Network Debug sessions

Only visits for this tool are shown. Pasted content, tokens, request bodies, and logs are not stored here.

Loading this tool history...