Cordova iOS在Xcode16.2下构建遇Clang链接错误（退出码1）

环境信息 #

• Xcode 16.2
• Cordova: 12.0
• cordova-ios: 7.1.1
• Node: v23.5.0
• deployment_target 13

问题背景 #

Mac自动重启后默认使用Node v14.18.1，执行cordova build ios失败，未排查原因就执行了cordova platform remove/add ios，切换回Node v23.5.0后，构建始终报错，出现Clang链接错误提示32个重复符号（来自CDVFileTransfer的_kFormBoundary、_kOptionsKeyCookie等），链接命令退出码1，归档失败。

已尝试的修复步骤 #

1. 切换到Node v23.5.0后重新执行cordova platform remove/add ios
2. 重启Xcode
3. 在Xcode的Product菜单中执行clean project
4. 在项目platform/ios目录下执行pod update
5. 删除DerivedData文件夹
6. 确保Xcode工作区项目签名配置正确

额外可尝试的修复方案 #

• 检查重复插件引用：执行cordova plugin list，查看是否存在多个版本或重复的文件传输类插件，卸载多余的后重新添加iOS平台。
• 清理项目依赖缓存：删除项目根目录下的node_modules、package-lock.json，执行npm install重新安装依赖，再运行cordova clean和cordova platform add ios。
• 排查Xcode项目重复文件：打开platform/ios下的.xcworkspace，搜索CDVFileTransfer相关文件，删除重复的.m/.h文件，清理项目后重新构建。
• 重置Pod依赖：删除platform/ios目录下的Podfile.lock，执行pod install重新安装Pod依赖，避免版本冲突导致的重复符号。
• 切换稳定版Node：Node v23为开发版，存在兼容性风险，切换至LTS版本（如v20.x），重新执行平台移除/添加操作后构建。
• 检查编译源重复条目：在Xcode的项目Build Phases -> Compile Sources中，移除重复的CDVFileTransfer源文件条目，再尝试构建。
• 重新初始化项目：备份项目的www目录、config.xml、插件列表，创建新的Cordova项目，恢复备份内容后重新添加iOS平台和插件，再进行构建。

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