.NET MAUI Android平台访问AppData文件夹时出现权限拒绝问题

安全阿岳

2026-6-29

Android平台访问AppData目录权限异常的解决方案

排查路径访问逻辑：/data/user/0/com.company.appname/files是应用的私有内部存储目录，理论上无需申请任何外部存储权限（READ_EXTERNAL_STORAGE/WRITE_EXTERNAL_STORAGE/MANAGE_EXTERNAL_STORAGE）即可读写。先确认代码中是否直接使用FileSystem.AppDataDirectory拼接文件路径，而非手动构造绝对路径——手动拼接易出现路径拼写错误或权限上下文问题。
移除冗余权限申请：既然目标是应用私有目录，直接删除AndroidManifest.xml中添加的外部存储权限，同时简化PermissionsHelper类的逻辑（无需再请求这些权限）。外部存储权限仅用于访问SD卡等公共存储区域，申请它们不仅没必要，还可能干扰应用自身的权限上下文。
检查文件写入代码细节：确保WriteObjectToJsonFile方法中使用正确的文件操作API，比如：
```
var targetPath = Path.Combine(FileSystem.AppDataDirectory, "your_file.json");
// 确保使用覆盖/创建模式写入
File.WriteAllText(targetPath, jsonString);
```
避免使用需要额外权限的文件操作方式，比如尝试以只读模式打开不存在的文件，或未正确处理流的关闭。
适配Android分区存储（针对Android 10+）：虽然私有目录不受分区存储限制，但如果代码中误调用了外部存储相关API，可能引发权限混淆。可在AndroidManifest.xml的<application>标签中添加android:requestLegacyExternalStorage="true"作为临时排查手段（若问题解决，说明代码中存在未察觉的外部存储访问逻辑）。
重置应用状态：卸载应用并清除残留数据，重新安装后测试。部分情况下，系统权限缓存或应用存储状态异常会导致看似矛盾的权限拒绝问题。