将应用targetSDK升至API 30后运行异常，如何排查故障原因？

故障定位步骤 #

• 优先排查核心变更模块：API 30的非废弃API相关行为变更集中在包可见性限制、分区存储权限、位置权限分级、前台服务类型声明四个领域，优先确认触发异常的功能是否涉及这四类场景，90%以上的升级异常都出自这几个模块的规则调整。
• 增加全链路日志打点：在权限申请、系统API调用、跨应用交互、文件读写的入口和返回处添加本地日志，记录调用参数、返回值、完整异常栈，对比升级前后同一功能的日志差异，快速定位被拦截或返回值变更的调用点。
• 对照测试验证：将同一代码分别编译为targetSDK 29和30的安装包，安装到Android 11（对应API 30）的测试设备上运行，对比触发异常功能时的系统行为、返回结果差异，重点关注无弹窗提示的静默拦截场景。
• 开启Lint兼容性扫描：在Android Studio中配置Lint规则为扫描API 30兼容性问题，扫描结果会自动标记所有不符合API 30规则的调用场景，比如未声明包可见性查询列表就调用跨应用接口、未申请对应权限就访问公共目录等隐性问题。

Android Studio 直观排查API 30影响的功能 #

• 兼容性追踪（Compatibility Tracing）：在App Inspection面板中开启该功能，选择目标API级别为30，运行应用时会实时标记所有触发了API 30行为变更的调用点，同时展示调用栈路径、和旧版本API的行为差异说明，无需手动对照官方变更列表即可定位影响点。
• 设备文件浏览器权限视图：针对存储类异常，打开Device File Explorer的权限显示列，可直观查看应用在API 30下对各个公共目录、私有目录的访问权限状态，哪些路径的读写操作被系统拦截可直接识别。
• 模拟器多API级别切换：同一Android 11模拟器镜像支持快速切换运行的API级别，无需多台测试设备即可对比同一功能在不同API级别下的运行差异，还可开启开发者选项中的「显示系统权限拦截通知」，所有API 30下被系统静默拦截的受限行为都会弹出提示。

内容的提问来源于stack exchange，提问作者auspicious99