iOS从Documents目录加载UIImage失败，报错文件无法读取求解决

我来帮你排查这个加载图片失败的问题！先从代码里的隐患说起，再给你靠谱的修正方案：

1. 路径拼接的坑点 #

你直接用字符串append拼接路径很容易出问题——比如可能出现重复的斜杠、或者子目录根本不存在，系统就找不到目标文件了。更稳妥的做法是用URL自带的appendingPathComponent方法，它会自动处理路径分隔符的问题。

2. 先确认文件真的在那里 #

加载前先检查文件是否存在，能快速定位是路径错了，还是文件压根没放到指定位置：

let fileManager = FileManager.default
if !fileManager.fileExists(atPath: url.path) {
    print("文件找不到！当前路径：\(url.path)")
    return
}

3. 修正后的完整代码 #

替换你原来的路径构建和加载逻辑，用更可靠的URL方式：

// 优先用URL获取Documents目录（比字符串更安全）
guard let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else {
    print("无法获取Documents目录")
    return
}

// 拼接子路径和目标文件名
let targetImageURL = documentsURL.appendingPathComponent("filescheme/filescheme/images/3.png")

// 先校验文件是否存在
let fileManager = FileManager.default
guard fileManager.fileExists(atPath: targetImageURL.path) else {
    print("错误：目标文件不存在，路径为\(targetImageURL.path)")
    return
}

// 加载图片数据
do {
    let imageData = try Data(contentsOf: targetImageURL)
    if let loadedImage = UIImage(data: imageData) {
        print("图片加载成功！")
        // 这里就可以使用loadedImage了
    } else {
        print("错误：这个文件不是有效的图片格式")
    }
} catch {
    print("加载数据失败：\(error.localizedDescription)")
}

额外排查小技巧 #

• 可以通过Xcode的「Devices and Simulators」查看App的容器文件，确认filescheme/filescheme/images/3.png是不是真的在Documents目录下；
• 如果是通过其他逻辑把图片写入这个目录的，要保证写入时的路径和读取时完全一致，别出现写入路径和读取路径不匹配的情况。

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