Swift/SwiftUI中在iCloud Documents应用目录创建文件夹报错排查

我需要在iCloud Documents的应用专属目录内创建新文件夹，已经在Xcode的Signing & Capabilities中添加了iCloud功能，但运行代码时控制台报错：Error: Could not access iCloud container。

使用的代码如下：

import SwiftUI

struct ContentView: View {
    @State private var folderName = "NewFolder" // Folder name from a string
    
    var body: some View {
        VStack {
            Button("Create Folder") {
                createFolderInICloud(folderName: folderName)
            }
        }
        .padding()
    }
    
    func createFolderInICloud(folderName: String) {
        // Get the URL for the iCloud container (replace "com.yourcompany.yourapp" with your app's iCloud identifier)
        guard let iCloudURL = fileManagerURLForICloud() else {
            print("Error: Could not access iCloud container")
            return
        }
        
        // Combine the iCloud URL with the desired folder name
        let folderURL = iCloudURL.appendingPathComponent(folderName)
        
        do {
            // Check if the folder already exists
            if !FileManager.default.fileExists(atPath: folderURL.path) {
                // Create the folder
                try FileManager.default.createDirectory(at: folderURL, withIntermediateDirectories: true, attributes: nil)
                print("Folder created successfully at: \(folderURL.path)")
            } else {
                print("Folder already exists at: \(folderURL.path)")
            }
        } catch {
            print("Failed to create folder: \(error)")
        }
    }
    
    func fileManagerURLForICloud() -> URL? {
        let fileManager = FileManager.default
        // Access the iCloud container using the app's iCloud identifier (replace with your actual iCloud container identifier)
        return fileManager.url(forUbiquityContainerIdentifier: "com.mycompany.myapp")?.appendingPathComponent("Documents")
    }
}

我怀疑iCloud容器配置有误，但已经启用了对应功能，请问该如何排查并解决？

排查与解决步骤 #

1. 核对iCloud容器标识符 #

• 打开Xcode项目的Signing & Capabilities标签，找到iCloud模块下的Containers条目，容器标识符通常带iCloud.前缀（比如iCloud.com.mycompany.myapp），代码中url(forUbiquityContainerIdentifier:)的参数必须和这个标识符完全一致，不能遗漏前缀。

2. 检查开发者后台配置 #

• 登录Apple开发者后台，进入Certificates, Identifiers & Profiles，找到对应App ID，确认iCloud服务已启用，且关联的容器状态为“Active”，没有配置异常。

3. 验证设备iCloud状态 #

• 测试设备或模拟器需登录有效的Apple ID，且在设置→[你的名字]→iCloud→iCloud Drive中开启服务。模拟器若出现异常，可尝试重启或重新登录iCloud。

4. 确认项目签名配置 #

• 确保项目Signing部分使用正确的开发者账号，开启自动管理签名，避免因签名不匹配导致iCloud权限失效。可尝试清理项目缓存（Cmd+Shift+K）后重新构建。

5. 修正代码逻辑 #

• 添加ubiquityIdentityToken验证，确保iCloud已正常连接；同时改用fileExists(atPath:isDirectory:)准确判断目录是否存在：

修正后的代码：

import SwiftUI

struct ContentView: View {
    @State private var folderName = "NewFolder"
    
    var body: some View {
        VStack {
            Button("Create Folder") {
                createFolderInICloud(folderName: folderName)
            }
        }
        .padding()
    }
    
    func createFolderInICloud(folderName: String) {
        guard let iCloudURL = fileManagerURLForICloud() else {
            print("Error: Could not access iCloud container")
            return
        }
        
        let folderURL = iCloudURL.appendingPathComponent(folderName)
        var isDirectory: ObjCBool = false
        let exists = FileManager.default.fileExists(atPath: folderURL.path, isDirectory: &isDirectory)
        
        do {
            if !exists || !isDirectory.boolValue {
                try FileManager.default.createDirectory(at: folderURL, withIntermediateDirectories: true, attributes: nil)
                print("Folder created successfully at: \(folderURL.path)")
            } else {
                print("Folder already exists at: \(folderURL.path)")
            }
        } catch {
            print("Failed to create folder: \(error)")
        }
    }
    
    func fileManagerURLForICloud() -> URL? {
        let fileManager = FileManager.default
        // 替换为你实际的iCloud容器标识符（带iCloud前缀）
        guard let containerURL = fileManager.url(forUbiquityContainerIdentifier: "iCloud.com.mycompany.myapp"),
              fileManager.ubiquityIdentityToken != nil else {
            return nil
        }
        return containerURL.appendingPathComponent("Documents")
    }
}

6. 注意iCloud同步延迟 #

• iCloud操作存在同步延迟，创建文件夹后可稍等片刻，再通过iCloud Drive确认是否生成。

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