Flutter项目iOS模拟器编译报错：Xcode链接命令失败

错误信息 #

执行flutter run --verbose时触发以下链接错误：

[   +1 ms] Error (Xcode): Building for 'iOS-simulator', but linking in object file (/Users/user/Documents/GitHub/my_app/ios/Pods/GoogleMaps/Maps/Frameworks/GoogleMaps.framework/GoogleMaps) built for 'iOS'
           
[        ] Error (Xcode): Linker command failed with exit code 1 (use -v to see invocation)

解决方案 #

1. 彻底清理并重建依赖缓存

执行以下命令清除本地构建缓存和Pods依赖，重新拉取所有资源：

flutter clean
cd ios
pod deintegrate
pod cache clean --all
rm -rf Podfile.lock .symlinks Flutter/Flutter.framework Flutter/Flutter.podspec
cd ..
flutter pub get
cd ios
pod install

2. 配置Podfile适配GoogleMaps架构

在ios/Podfile的post_install代码块中添加GoogleMaps的架构兼容配置：

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    if target.name == 'GoogleMaps'
      target.build_configurations.each do |config|
        # 同时支持模拟器和真机架构
        config.build_settings['VALID_ARCHS'] = 'arm64 x86_64'
        # M系列Mac模拟器排除arm64避免架构冲突
        config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
      end
    end
  end
end

修改完成后重新执行pod install。

3. 调整Xcode项目架构设置

打开ios/Runner.xcworkspace，选中Runner target进入Build Settings：

• Architectures > Architectures：设置为Standard Architectures (arm64, x86_64)
• Architectures > Excluded Architectures：在模拟器（Debug/Release）配置中添加arm64（仅针对M系列芯片Mac）
• Build Options > Validate Workspace：设置为Yes，让Xcode自动检测架构冲突

4. 检查.gitignore配置

确保.gitignore没有错误忽略以下关键文件（对比团队标准配置）：

• ios/Podfile.lock：保证依赖版本与团队完全一致
• ios/Runner.xcworkspace/contents.xcworkspacedata：避免本地工作区配置异常
• 若手动修改过.gitignore，恢复被错误排除的iOS构建相关文件

5. 对齐依赖版本

对比团队成员的pubspec.yaml和Podfile.lock，确保google_maps_flutter及相关依赖版本完全一致，执行flutter pub get同步版本。

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