更新SPM包版本后Xcode出现‘Missing package product 'GoogleUtilities_UserDefaults'’错误

• 检查包依赖配置

  • 不管用SPM还是CocoaPods，先确认Firebase相关依赖的配置是否正常。SPM项目直接打开Package.swift，看看有没有误写GoogleUtilities_UserDefaults的产品引用；Xcode里进入「项目设置」→「Package Dependencies」，点开Firebase条目，检查勾选的产品里有没有多余选项。如果是CocoaPods管理，直接执行pod deintegrate清掉旧配置，再重新pod install试试。

• 彻底清理Xcode缓存

  • 先按Cmd+Shift+K清理项目构建文件夹，再按Cmd+Option+Shift+K清理Xcode全局缓存。还可以打开Xcode偏好设置→Locations，找到DerivedData的路径，删掉对应项目的文件夹，甚至整个DerivedData目录都删除，避免缓存残留干扰。

• 排查Firebase的间接依赖

  • GoogleUtilities_UserDefaults大概率是Firebase子组件的间接依赖，你可以在Xcode的「Packages」目录下展开Firebase的所有子包，查看GoogleUtilities相关组件里是否包含这个模块。如果是版本冲突导致的缺失，试试在Package.swift里手动指定GoogleUtilities的兼容版本，比如：

    dependencies: [
        .package(url: "https://github.com/google/GoogleUtilities.git", from: "7.11.0"),
        // 其他依赖
    ]
    

    然后在target的dependencies里添加对应的产品引用（如果确实需要），强制统一依赖版本。

• 检查项目构建配置残留

  • 进入项目的「Build Settings」→「Linking」→「Other Linker Flags」，看看有没有残留的-GoogleUtilities_UserDefaults标记，有的话直接删除。再去「Build Phases」→「Link Binary With Libraries」里确认，有没有不存在的该组件条目，存在的话移除。

• 用最小项目验证问题

  • 新建一个空白Swift项目，只添加Firebase 10.27版本的依赖，看看能否正常编译。如果可以，说明原项目存在配置残留问题，逐步将原项目的代码、配置迁移到新项目中，就能定位出具体问题点。

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