MacOS注册File Provider域报错：未找到指定标识符的有效文件提供者

问题描述 #

在macOS环境中调用NSFileProviderManager.add(domain)注册File Provider域时，偶发性出现以下错误：

Error adding File Provider domain: No valid file provider found with identifier ‘MyApp.FinderExtensionHost’

注意：报错中提到的标识符是宿主App的Bundle ID，但代码中实际传入的是Finder扩展的Bundle ID MyApp.FinderExtensionHost.Extension。执行pluginkit -mvv -p com.apple.fileprovider-nonui也无法在列表中找到目标扩展。

项目结构（Xcode） #

• 宿主App：SwiftUI隐藏窗口应用，负责注册文件提供者，Bundle ID为MyApp.FinderExtensionHost，已配置App Group group.MyApp
• Apple File Provider Finder扩展：插件扩展，Bundle ID为MyApp.FinderExtensionHost.Extension，已配置相同的App Group group.MyApp

已尝试操作（效果不稳定） #

执行以下命令清理缓存：

pkill -9 cloudd
pkill -9 bird
pkill -9 fileproviderd
killall Finder

可能的解决方案 #

1. 检查Finder扩展的Info.plist配置 #

确保扩展的Info.plist中正确配置File Provider相关键：

• NSExtension -> NSExtensionAttributes -> NSFileProviderDomainIdentifier：需设置为扩展的Bundle ID（MyApp.FinderExtensionHost.Extension）
• NSExtension -> NSExtensionPointIdentifier：必须是com.apple.fileprovider-nonui（对应Finder扩展的非UI类型）
• 确认CFBundleIdentifier与代码中传入的扩展ID完全一致，无拼写错误

2. 验证插件注册状态 #

• 彻底重装应用：先卸载宿主App，删除~/Library/Containers/下对应宿主和扩展的容器目录，再重新编译安装
• 手动触发插件注册：执行pluginkit -r /Applications/YourApp.app/Contents/PlugIns/YourExtension.appex（替换为实际的扩展路径），强制系统识别插件
• 检查签名有效性：确保宿主App和扩展使用相同的开发者证书签名，用codesign -vvv /Applications/YourApp.app和codesign -vvv /Applications/YourApp.app/Contents/PlugIns/YourExtension.appex验证签名状态

3. 确认App Group配置一致性 #

• 宿主App和扩展的App Group必须完全一致，且已在Apple Developer后台启用该权限
• 调用NSFileProviderManager.add(domain)时，确保NSFileProviderDomain的identifier字段使用扩展的Bundle ID，而非宿主App的ID

4. 排查偶发性问题根源 #

• 查看fileproviderd日志：执行log stream --predicate 'subsystem == "com.apple.FileProvider"' --info，实时追踪文件服务的注册细节，定位失败原因
• 避免并发注册：确保NSFileProviderManager.add(domain)的调用是串行执行的，防止系统服务出现竞态条件
• 重启系统：若缓存清理无效，重启macOS可解决插件注册的残留状态问题

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