文档版本
v2026.07.07.0
下载 PDF
权限与文件访问¶
页面目标¶
帮助你区分应用逻辑问题和系统文件访问限制。
支持的平台¶
- iOS / iPadOS：17.0 或更高版本。
- macOS：14 或更高版本。
适合谁阅读¶
- 被文件可见性或目标位置访问问题卡住的用户
- 需要把权限问题和应用逻辑失败分开的测试人员
准备条件¶
- 某个具体导入、导出或拖放路径已经失败或表现异常
- 你可以重试同一路径，并观察系统是否显示权限提示
操作步骤¶
- 重试同一路径，注意系统是否出现权限提示。
- 确认来源或目标位置对应用确实可访问。
- 检查失败是否符合平台规则，例如 iOS 上
PNG -> Photos。 - 记录准确错误文本和大致位置。
结果¶
- 你可以判断问题来自系统访问限制，还是另一个应用层问题。
当前最常见的权限场景¶
- 文件选择器看不到目标资料
- 文件选中后系统拒绝访问
- 写入目标位置时导出失败
- iOS 保存到 Photos 失败
- 拖放被系统阻止
建议排查顺序¶
- 检查系统是否显示了权限提示。
- 确认目标资料存放在应用可访问的位置。
- 在 iOS 上记住：Photos 目标只适用于
PNG。 - 在 macOS 上确认保存面板选择的目标位置可写。
- 重试完全相同的路径，确认是否复现。
需要知道的几个用户可见行为¶
- 用户主动取消文件选择时，应用不会把它当作错误弹窗。
- 拖放导入依赖系统提供有效
fileURL；没有权限时，应用无法解析它。 - 在 iOS 上，导出到
Photos是一条独立路径，不等同于普通Files导出。
建议记录的信息¶
- 平台和系统版本
- 大致目标位置
- 系统是否显示权限提示
- 失败发生在导入、导出还是拖放
- 准确错误文本
常见问题¶
文件明明存在，为什么选择器里看不到？¶
多数时候，这是系统访问范围限制，而不是应用不知道这个文件。把文件移到更直接可访问的位置再试。
导出失败一定是导出功能坏了吗？¶
不一定。目标位置不可写、权限缺失，或格式和目标位置不匹配，也会导致导出失败。
为什么保存到相册只支持 PNG？¶
因为 Photos 路径连接的是 PNG；其他导出格式使用 Files 或系统分享面板。