iOS本地URL路径加载图片遇崩溃问题排查求助

让我来帮你定位这个崩溃的根源——问题出在图片保存阶段的相对路径逻辑错误，导致读取时找不到文件，最终因强制解包nil触发致命错误。下面一步步拆解问题并给出修复方案：

核心错误分析 #

1. 保存逻辑的路径关系完全搞反了 #

你在创建imageURL时误用了URL(fileURLWithPath:relativeTo:)方法：

let relativePath = "\(uniqueRelativeID).jpg"
let relativeURL = URL(fileURLWithPath: relativePath)
let imageURL = URL(fileURLWithPath: outputPath, relativeTo: relativeURL)

这个方法的第二个参数是基准URL，你应该把documents目录作为基准，而非把相对路径当作基准。当前代码会生成一个完全错误的路径，导致图片根本没有保存到你预期的documents目录下，或者保存的路径和你后续读取时拼接的路径完全不匹配。

2. 保存的相对路径字符串无效 #

你最后调用saveVideoData(data: imageURL.relativeString)，这里的relativeString是基于错误的relativeURL生成的，并非真正相对于documents目录的路径。这就导致读取时拼接出来的路径找不到文件，UIImage(contentsOfFile:)返回nil，强制解包image!直接触发崩溃。

修正后的代码 #

保存图片与相对路径的正确实现 #

let uniqueRelativeID = NSUUID().uuidString
// 优先用URL API获取documents目录，比NSString更安全可靠
guard let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else {
    print("无法获取Documents目录")
    return
}
// 生成正确的绝对路径URL
let imageURL = documentsURL.appendingPathComponent("\(uniqueRelativeID).jpg")

do {
    guard let imageData = UIImageJPEGRepresentation(chosenImg, 1.0) else {
        print("图片转JPEG数据失败")
        return
    }
    try imageData.write(to: imageURL)
    // 直接保存相对于documents的文件名即可，这就是我们需要的相对路径
    let relativePath = "\(uniqueRelativeID).jpg"
    saveVideoData(data: relativePath)
} catch {
    print("写入图片文件出错：\(error)")
}

读取图片的安全实现（避免强制解包） #

// 先验证pendingPostData中的数据类型
guard let imageRelativeURL = pendingPostData[2] as? String else {
    print("相对路径字符串无效")
    return
}
guard let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask).first else {
    print("无法获取Documents目录")
    return
}
// 用URL的appendingPathComponent拼接路径，避免字符串拼接的潜在问题
let imageURL = documentsURL.appendingPathComponent(imageRelativeURL)

// 先检查文件是否存在
guard FileManager.default.fileExists(atPath: imageURL.path) else {
    print("图片文件不存在：\(imageURL.path)")
    return
}
// 安全获取图片，绝不强制解包
if let image = UIImage(contentsOfFile: imageURL.path) {
    let imageData = UIImageJPEGRepresentation(image, 1.0)
    // 在这里继续处理imageData
} else {
    print("加载图片失败")
}

关键注意事项 #

• 尽量使用URL API处理文件路径，避免直接字符串拼接，能有效规避路径分隔符、特殊字符等问题。
• 永远不要随意使用!强制解包可选类型，尤其是涉及文件操作的场景，一定要用if let或guard let做安全校验。
• 保存相对路径时，只需要保存文件名（或相对于documents的子路径）即可，不需要生成错误的相对URL对象。

内容的提问来源于stack exchange，提问作者Michael Jajou