Android Bluetooth Troubleshooting

Use this skill to debug Android Bluetooth problems systematically instead of guessing between permissions, transport choice, adapter state, discovery, pairing, connection, and lifecycle issues.

When to Use This Skill

• Bluetooth features do not start, scan, discover, pair, connect, reconnect, or transfer data correctly.
• An Android app behaves differently across API levels.
• BLE scanning or GATT connection logic is unstable.
• Classic Bluetooth discovery or RFCOMM socket setup fails intermittently.
• A code review needs a focused Bluetooth debugging checklist.

Troubleshooting Goals

• Isolate the failing stage of the workflow.
• Verify the app is using the right transport model.
• Identify permission and platform-version mismatches.
• Confirm the app cleans up adapters, scans, sockets, callbacks, and connections correctly.