iPhone模拟器下使用FileManager获取用户文档目录返回nil致文件写入失败

问题描述 #

• 尝试实现本地文件写入功能未成功，调试发现通过FileManager获取用户文档目录的返回值为nil，判定该问题是文件无法正常存储的核心原因。
• 调试过程中观测到链路相关变量documentFolderURL、fileURL、url均为nil。
• 存在两个相关概念疑问：
  • 系统定义的“用户文档目录”，是iCloud Drive内的Documents/路径，还是“我的iPhone”分类下的应用本地存储路径？
  • 代码生成的文件，是否需要跳出“文件”App的可视路径才能检索到？
• 当前测试环境为iPhone模拟器。

现有实现代码 #

let documentFolderURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).last
let ext: String = type ?? "pdf"
let name = "extrato." + ext
let fileURL = documentFolderURL?.appendingPathComponent(name)
do {
    if let url = fileURL {
        try file.write(to: url, options: .atomic)
    }
} catch {...}

问题解答 #

文档目录定义澄清 #

• 调用FileManager的urls(for:in: .userDomainMask)获取的.documentDirectory，是应用沙盒内的本地Documents目录，属于设备本地存储路径，归类在“我的iPhone”下的应用专属存储范围，和iCloud Drive的云端Documents目录没有绑定关系，除非手动开启了iCloud容器的同步配置，否则该方法永远不会返回iCloud路径。
• 这个沙盒内的默认Documents目录默认不会被“文件”App展示，需要在Target的“Signing & Capabilities”中开启文件共享、原地打开文档的相关权限，才会在“文件”App的“我的iPhone”分类下显示对应应用的存储文件夹，不需要跳转到“文件”App外的路径查找生成的文件。

模拟器下目录返回nil的常见诱因 #

• 模拟器沙盒权限损坏：模拟器长期使用、版本迭代后沙盒配置异常时，会直接导致路径查询返回空数组，最终所有下游变量都是nil。可以选中对应模拟器，在Xcode菜单栏点击Device > Erase All Content and Settings重置模拟器后重新运行测试。
• 调用时机过早：如果在全局变量初始化、App启动的最早阶段执行路径查询，沙盒还未完成挂载，也会出现路径返回空的情况，建议把路径获取逻辑移到视图控制器的viewDidLoad或更靠后的生命周期中执行。
• 取值逻辑的潜在问题：代码里用.last取路径数组的最后一个元素，正常情况下这个方法返回的数组只会有1个本地路径，数组为空时.last就会返回nil。建议改成取.first，同时加日志打印返回数组的count值，直接确认路径查询本身是否返回了空结果。

模拟器环境下的文件查找方式 #

• 可以在调试时直接打印documentFolderURL的完整路径，在Mac的访达中按Shift+Cmd+G粘贴路径，就能直接定位到存储的文件，不需要在“文件”App里反复查找。

内容的提问来源于stack exchange，提问作者Thainá Mariani