Swift代码复制JPG文件至另一文件夹报错求助

嘿，我看你在用FileManager的copyItem方法复制JPG图片时碰到了沙箱路径相关的错误，这在iOS开发里确实是个高频踩坑点，咱们一步步拆解问题、解决它。

先说说你代码里可能存在的几个问题 #

1. 目标路径不完整：很多人容易忽略——destinationPath必须是完整的文件路径（包含文件名），而不是仅仅是目标文件夹的路径。比如你要把origin.jpg复制到destFolder里，目标路径得是/xxx/destFolder/origin.jpg，不能只写/xxx/destFolder/。
2. 目标文件夹未创建：FileManager不会自动帮你创建目标路径的父文件夹，如果文件夹不存在，复制操作直接失败。
3. 错误处理不严谨：你当前的errorBlock里返回的是新建的NSError()，这会丢失真实的错误信息，不利于排查问题，应该直接返回捕获到的原生错误。
4. 硬编码沙箱路径风险：你提到的路径里包含App容器的UUID，这个UUID是动态变化的（App重装、重启后可能改变），硬编码路径很容易导致路径失效。

修正后的完整代码 #

下面是调整后的方法，解决了上述问题，还增加了文件存在时的覆盖处理：

func moveItems(originPath: String, destinationPath: String, successBlock:@escaping () -> Void, errorBlock:@escaping (_ error: Error) -> Void) {
    let fileManager = FileManager.default
    
    // 1. 获取目标路径的父文件夹，确保文件夹存在
    let destinationFolder = (destinationPath as NSString).deletingLastPathComponent
    do {
        // withIntermediateDirectories设为true，会自动创建所有不存在的父文件夹
        try fileManager.createDirectory(atPath: destinationFolder, withIntermediateDirectories: true, attributes: nil)
    } catch {
        print("创建目标文件夹失败：\(error.localizedDescription)")
        errorBlock(error)
        return
    }
    
    // 2. 如果目标文件已存在，先删除（可选，根据业务需求调整）
    if fileManager.fileExists(atPath: destinationPath) {
        do {
            try fileManager.removeItem(atPath: destinationPath)
        } catch {
            print("删除已存在的目标文件失败：\(error.localizedDescription)")
            errorBlock(error)
            return
        }
    }
    
    // 3. 执行复制操作
    do {
        try fileManager.copyItem(atPath: originPath, toPath: destinationPath)
        successBlock()
    } catch {
        print("复制文件失败：\(error.localizedDescription)")
        errorBlock(error) // 返回真实错误，方便排查
    }
}

正确的调用示例（推荐用URL而非String路径） #

建议尽量用URL来管理文件路径，比字符串拼接更安全：

let fileManager = FileManager.default
// 通过API获取沙箱目录，避免硬编码
guard let documentsDir = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first else {
    print("无法获取Documents目录")
    return
}

// 源文件URL（比如Documents下的test.jpg）
let originURL = documentsDir.appendingPathComponent("test.jpg")
// 目标文件URL（比如Documents下的subfolder里的test_copy.jpg）
let destinationURL = documentsDir.appendingPathComponent("subfolder/test_copy.jpg")

// 转成String路径调用方法
moveItems(originPath: originURL.path, destinationPath: destinationURL.path, successBlock: {
    print("图片复制成功！")
}, errorBlock: { error in
    print("复制失败，错误详情：\(error)")
})

额外注意点 #

• 优先使用URL相关API：FileManager提供了copyItem(at:to:)方法，直接传URL比传String路径更不容易出错。
• 权限问题：如果是复制沙箱外的文件（比如相册、iCloud文件），需要先申请对应的系统权限；沙箱内的文件则不需要额外权限。

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