Android 调试构建版无法查看Scoped Storage存储的文件列表问题

• 排查debug构建应用ID后缀差异
  大部分项目会在debug构建变种中配置applicationIdSuffix ".debug"，而getExternalFilesDir()返回的应用专属目录路径和应用ID完全绑定，路径规则为Android/data/[当前应用ID]/files。如果debug应用ID和QA包不一致，debug包只能读取自身ID对应目录的内容，自然读不到QA包写入的文件，返回列表为空。

验证方式：分别在debug和QA环境下打印getExternalFilesDir(null).getAbsolutePath()，对比两个路径是否完全一致。

• 排查debug构建数据自动清除配置
  Android Studio默认会开启debug构建安装时自动清除应用数据的选项，每次重新安装debug包都会清空专属目录下的所有历史文件，而QA包为正常安装不会自动清理数据，就会出现debug启动后目录为空的情况。

验证方式：在debug环境下先主动写入一个测试文件到getExternalFilesDir()目录，再读取文件列表，如果能读到刚写入的文件即可确认是该原因导致。

• 排查变体分支逻辑错误
  检查代码中是否存在BuildConfig.DEBUG相关的分支判断，是否存在debug模式下错误修改文件读写路径、跳过文件写入逻辑的代码。

验证方式：在文件写入、文件列表读取的核心代码处加断点，debug运行时确认执行路径、传入的路径参数是否符合预期。

• 排查权限配置差异
  虽然getExternalFilesDir()本身不需要申请任意存储权限即可读写，但部分Android 10以下的定制ROM，会在应用未授予存储权限时限制专属目录的读写操作。检查debug和QA构建的AndroidManifest.xml权限配置差异，以及debug环境下是否手动拒绝过存储权限。

• 排查热部署功能异常
  开启Android Studio Instant Run（热部署）功能时，偶尔会出现应用目录权限异常的问题，导致无法正常读写专属目录。

解决方式：关闭热部署后全量编译重新安装debug包，验证问题是否消失。

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