FileManager.moveItem按后缀分类JPG文件同名报错问题排查

核心报错原因定位 #

• 移动触发逻辑写反：原代码将文件移动操作嵌套在「创建子文件夹」的异常捕获分支中，意味着只有创建文件夹失败（即文件夹已存在）时才会执行移动。当处理某类后缀的第一个文件时，子文件夹不存在，创建操作会直接成功，完全不会进入移动分支，该文件永远留在原目录。
• 目标路径拼接错误：原代码计算的目标路径dest仅指向子文件夹本身，没有拼接原文件的名称。在多数系统版本的FileManager规则中，只要moveItem的目标路径已存在（哪怕是文件夹），就会直接抛出“已存在同名文件”错误，不会自动将源文件移入目录，这是移动操作全部失败的直接原因。
• 异常捕获无效：外层空的catch块会吞掉所有目录读取类错误（比如权限不足、路径无效），完全无法感知异常；嵌套的异常逻辑没有判断错误类型，只要创建文件夹报错就盲目执行移动，逻辑完全不可控。
• 文件名解析缺少边界判断：直接按分隔符拆分文件名、访问数组下标，遇到文件名无下划线、无后缀的情况会直接触发数组越界崩溃；同时没有过滤目录里的子文件夹、非JPG文件，会把目录项当成文件错误处理。

针对性优化调整 #

• 调整执行顺序：每处理一个文件，先确保对应子文件夹存在，再拼接包含原文件名的完整目标文件路径，最后再执行移动操作。
• 子文件夹创建时开启withIntermediateDirectories，即使嵌套路径不存在也能自动创建，避免不必要的错误捕获。
• 增加边界判断：跳过目录中的子文件夹、非JPG格式文件，文件名解析时做非空校验，避免越界崩溃。
• 简化异常捕获逻辑，明确打印错误信息，方便后续排查问题。

优化后代码 #

private let fm = FileManager.default
func separateExtractedJPGsInDirectoryAtURL(url: URL) {
    do {
        let contents = try fm.contentsOfDirectory(
            at: url,
            includingPropertiesForKeys: [.isDirectoryKey],
            options: [.skipsHiddenFiles]
        )
        for fileURL in contents {
            // 跳过目录中的子文件夹，仅处理文件
            let resourceValues = try fileURL.resourceValues(forKeys: [.isDirectoryKey])
            guard resourceValues.isDirectory == false else { continue }
            // 仅处理JPG格式文件
            guard fileURL.pathExtension.lowercased() == "jpg" else { continue }
            // 解析文件名提取分类标识，增加非空判断避免越界
            let fileName = fileURL.lastPathComponent
            let fileNameComponents = fileName.components(separatedBy: "_")
            guard let lastSegment = fileNameComponents.last else {
                print("跳过格式异常文件：\(fileName)")
                continue
            }
            let typeComponents = lastSegment.components(separatedBy: ".")
            guard let jpgType = typeComponents.first, !jpgType.isEmpty else {
                print("跳过无法识别类型的文件：\(fileName)")
                continue
            }
            // 确保分类子文件夹存在
            let targetFolderURL = url.appendingPathComponent(jpgType, isDirectory: true)
            try fm.createDirectory(at: targetFolderURL, withIntermediateDirectories: true, attributes: nil)
            // 拼接完整的目标文件路径（原代码核心缺失步骤）
            let targetFileURL = targetFolderURL.appendingPathComponent(fileName)
            // 执行文件移动
            try fm.moveItem(at: fileURL, to: targetFileURL)
        }
    } catch {
        print("目录处理失败：\(error.localizedDescription)")
    }
}

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