Android - 常见问题 实战配置

发布时间:2026-05-01 16:01

一、前言 搞过Android开发的人都知道，最烦的不是写代码，而是明明功能没问题，应用就是跑不起来——ADB连不上、日志看不到、权限被拒、闪退找不到原因。这些问题占了我们80%的排错时间。今天把干了10年遇到的高频坑全部抖出来，全是实战经验，不整虚的。 二、操作步骤

步骤1：ADB设备检测不到？先排查这些基础项

当你执行adb devices发现空列表，别急着重装驱动。按这个顺序查： ```bash # 检查ADB服务状态 $ adb kill-server $ adb start-server # 检查设备识别情况 $ lsusb | grep -i android Bus 001 Device 012: ID 18d1:4ee7 Google Inc. Nexus/Pixel Device (MTP + ADB) # 确认USB调试已开启（手机端需手动授权） $ adb devices List of devices attached xxxxxxxx device ``` 预期输出：设备应该出现在列表中，状态为device而非unauthorized。

步骤2：应用莫名闪退？先抓日志看堆栈

闪退问题最烦，没有日志就是瞎猜。ADB连接成功后，用logcat抓崩溃日志： ```bash # 实时抓取应用崩溃日志 $ adb logcat | grep -i "FATAL\|AndroidRuntime\|Exception" # 或者指定包名抓取（把com.example.app换成你的包名） $ adb logcat --pid=$(adb shell pidof com.example.app) # 导出完整日志到本地分析 $ adb logcat -d > app_crash_log.txt ``` 预期输出：会看到FATAL EXCEPTION信息，包含具体崩溃类和行号，比如NullPointerException: Attempt to invoke virtual method on a null object reference。 警告：日志文件可能很大，生产环境记得加时间过滤，不然手机存储分分钟爆掉。

步骤3：权限被拒绝？查清是运行时权限还是系统权限

Android 6.0之后大量权限改成运行时请求，老代码直接崩。先确认是什么类型的权限问题： ```bash # 查看应用当前权限状态 $ adb shell dumpsys package com.example.app | grep permission # 查看具体权限的grant状态 $ adb shell dumpsys package com.example.app | grep -A 5 "runtime permissions" # 对于系统权限问题，检查selinux状态（Android 10+常见） $ adb shell getenforce Enforcing $ adb shell dmesg | grep avc # 会显示selinux权限拒绝的详细audit信息 ``` 预期输出：runtime permissions部分会显示每个危险权限的granted状态，getenforce显示Enforcing或Permissive。

步骤4：网络调试连不上？端口和防火墙先过一遍

用adb connect远程调试，或者WiFi ADB经常出问题。按这个顺序查： ```bash # 本地ADB端口检查 $ adb nodaemon server $ adb kill-server $ lsof -i :5037 | grep adb # 通过IP连接设备（确保设备和电脑在同一网段） $ adb connect 192.168.1.100:5555 connected to 192.168.1.100:5555 # 连接失败时检查设备端ADB端口状态 $ adb shell netstat -tlnp | grep 5555 ``` 预期输出：本地5037端口被ADB占用，远程设备5555端口处于LISTEN状态即为正常。 警告：开放5555端口有安全风险，调试完毕后记得adb disconnect或在设备设置里关闭网络调试。

步骤5：应用启动慢？用 systrace 找瓶颈

用户说卡，你得有证据。Android Studio自带的 systrace 或 Perfetto 是分析卡顿的利器： ```bash # 使用 systrace 抓取启动 trace $ python $ANDROID_HOME/platform-tools/systrace/systrace.py --time=10 -o startup_trace.html sched freq idle am wm gfx view binder_driver # 同步触发应用启动 $ adb shell am start -W com.example.app/.MainActivity Starting: Intent { cmp=com.example.app/.MainActivity } Status: ok LaunchState: COLD TotalTime: 1234 WaitTime: 1256 ``` 预期输出：生成HTML文件，用Chrome浏览器打开后可看到各阶段耗时，红色的部分就是瓶颈。

步骤6：ANR问题？用traces.txt定位主线程阻塞

应用无响应（ANR）最让用户抓狂。系统会在/data/anr/目录生成traces.txt： ```bash # 读取最新ANR traces（需要root或debuggable应用） $ adb shell cat /data/anr/traces.txt # 搜索指定包名的ANR记录 $ adb shell "cat /data/anr/traces.txt" | grep -A 30 "com.example.app" # 如果文件权限不足，尝试pull（部分设备支持） $ adb pull /data/anr/traces.txt ./ ``` 预期输出：看到"main"线程的堆栈，如果显示在某个IO操作或锁等待上，那就是问题根源。

步骤7：内存泄漏？用Android Profiler或adb dumpsys定位

内存问题是慢刀子磨人，OOM崩溃前用户感知不到。先用命令行快速扫描： ```bash # 查看应用内存使用概览 $ adb shell dumpsys meminfo com.example.app # 关注这几项： # Native Heap: native层内存 # Dalvik Heap: Java层内存 # TOTAL: 总内存占用 # 强制GC后再次检查（看是否有未释放对象） $ adb shell "run-as com.example.app dumpsys meminfo --unreachable 1" ``` 预期输出：TOTAL显示当前占用，GC后再次dump，对比是否有对象未释放。持续增长就是泄漏。 三、常见问题FAQ Q：adb devices显示unauthorized，授权弹窗也没有怎么办？ A：这是最恶心的场景。先拔掉USB线，执行adb kill-server，然后重新插线时注意看手机屏幕——有些机型第一次连接授权弹窗出现很快，你可能没看到。如果还是不行，换根数据线，有些劣质线只充电不传数据。还可以试试把USB连接模式从MTP改成PTP。 Q：logcat日志太多，根本看不到自己的内容怎么办？ A：别傻傻盯着实时输出。先用-d参数导出，然后本地用grep过滤。另一个技巧是给应用打上自定义tag，adb logcat -s MyTag:V，只看你关心的。另外记住缓冲区概念：ring buffer默认只存几MB内容，如果日志太多太频繁，老日志会被覆盖。生产环境建议写到文件或者用FIFO管道。 Q：应用在Debug环境正常，Release包一装就崩，为什么？ A：混淆规则把关键代码干掉了。检查proguard-rules.pro，特别是用了反射的地方——类名、方法名被改成a、b，运行时找不到。另一个常见原因是签名问题，特别是多渠道打包时用了不同keystore。还有就是Debug模式关了Assertion，Release版本assert语句不执行，逻辑就变了。 Q：应用卡顿，但systrace抓不到明显问题怎么办？ A：说明瓶颈可能不在主线程。试试Perfetto抓更长时间，看IO线程、GPU线程有没有阻塞。另外很多卡顿是帧率问题，不是ANR，用GPU呈现模式分析更直接：开发者选项里打开"GPU渲染模式分析"，选"在屏幕上显示为条形图"，实际操作应用，看有没有绿色竖条超过16ms红线。 Q：老手机上的ANR问题，新手机复现不了，怎么调试？ A：换个思路——不是复现不了，是环境差异。你需要拿到ANR发生时的traces.txt，这是最重要的证据。如果拿不到，就靠日志里的时间戳去对，分析ANR前最后几步在做什么。常见原因：老手机IO慢，数据库操作没做异步；老手机内存小，后台进程被杀导致应用被OOM Killer盯上；低端GPU驱动不完善，OpenGL调用直接卡死。 四、总结 核心要点：Android问题排查讲究的是证据链，ADB是万能入口，日志是破案关键。遇到问题别猜，先跑一遍adb devices确认连接、adb logcat抓崩溃、adb shell dumpsys查状态。闪退看异常堆栈，卡顿看trace，内存看dumpsys，ANR看traces.txt。养成用命令行排查的习惯，比点鼠标快十倍。 延伸阅读：Android官方性能优化文档（developer.android.com/topic/performance）、Perfetto官方教程、Google I/O关于Android性能的长篇分享，这些资料看完能让你再上一个台阶。遇到新问题，先查官方issue tracker，很多坑前人已经踩过。