目标SDK29应用在Android 11上配置requestLegacyExternalStorage仍无法访问外部存储

1. 优先排查配置错漏导致的legacy模式失效 #

• 确认android:requestLegacyExternalStorage="true"的配置位置：必须放置在<application>标签内部，错误放置在Manifest根标签、四大组件标签下都会被系统忽略，在Android 11上直接失效
• 确认动态权限申请流程完整：即使开启了legacy存储模式，Android 6.0及以上系统仍然需要动态申请READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE权限，不能依赖Manifest静态声明就直接访问存储
• 确认APK实际的targetSdk版本：不要只依赖build.gradle中编写的配置，要通过aapt工具对实际安装包做解析，排查是否存在构建变体、第三方插件覆盖targetSdk为30及以上的情况，只要实际targetSdk≥30，Android 11会直接忽略legacy存储配置

2. 厂商定制ROM的适配问题 #

部分国内厂商定制的Android 11系统，即使应用满足targetSdk=29的legacy生效条件，也会对全新安装的应用默认关闭legacy外部存储访问权限，只有从Android 10版本升级覆盖安装的应用才会保留对应权限。
碰到这类问题不要硬调整配置：

• 针对日志存储的场景，优先切换到应用专属外部目录getExternalFilesDir()，该目录不需要申请任何存储权限，不受Scoped Storage规则约束，存储日志完全满足需求，也不会被厂商ROM拦截
• 若必须访问公共外部存储，可引导用户在应用权限设置页手动开启“所有文件访问权限”，不要依赖legacy配置自动获取权限

3. 非必要场景的长期适配建议 #

如果不需要跨应用共享日志文件，完全不需要依赖传统外部存储的访问权限：

• 应用专属外部目录的路径可直接通过代码获取，无权限拦截问题，卸载应用时文件会自动清理
• 若需要让用户手动导出日志，可通过SAF存储访问框架让用户主动选择存储位置，不需要申请全量存储权限

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