Flutter iOS模拟器启动崩溃：DYLD 4缺失SwiftProtobuf符号

核心问题 #

1. 架构不兼容：iOS模拟器（x86_64架构）与项目指定的arm64架构冲突，导致运行时不匹配
2. 依赖符号缺失：iProov.framework引用的SwiftProtobuf专属符号_$s13SwiftProtobuf19_ProtoNameProvidingP17_protobuf_nameMapAA01_dH0VvgZTq未找到，本质是依赖版本不匹配或CocoaPods配置异常

具体修复步骤 #

1. 解决架构不兼容问题 #

• 打开iOS项目的Runner.xcworkspace，进入Runner Target → Build Settings
• 搜索Excluded Architectures，在Debug配置下添加arm64（仅针对模拟器环境）
• 搜索Build Active Architecture Only，设置为YES（仅Debug模式生效）
• 修改Podfile，添加强制模拟器架构配置：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      flutter_additional_ios_build_settings(target)
      # 强制Debug模拟器使用x86_64架构
      target.build_configurations.each do |config|
        if config.name == 'Debug' && config.build_settings['SDKROOT'] == 'iphonesimulator'
          config.build_settings['ARCHS'] = 'x86_64'
        end
      end
    end
  end
  

2. 修复SwiftProtobuf符号缺失问题 #

• 查看Podfile.lock中SwiftProtobuf的版本，确保与iProov依赖的版本完全一致
• 执行命令清理缓存并重装依赖：

  flutter clean
  rm -rf ios/Pods
  rm ios/Podfile.lock
  pod repo update
  cd ios && pod install
  

• 若问题持续，在Podfile中指定SwiftProtobuf的兼容版本（版本号需匹配iProov官方要求）：

  pod 'SwiftProtobuf', '~> 1.21.0'
  

3. 验证收尾步骤 #

• 执行Xcode清理：Xcode → Product → Clean Build Folder
• 重启Xcode与模拟器，重新构建运行项目

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