Flutter iOS CocoaPods报Protobuf兼容版本找不到问题求解

你遇到的是CocoaPods依赖版本约束无交集的典型问题：

• flutter_blue 依赖链要求 Protobuf 版本满足 ~> 3.11.4（即 >=3.11.4 且 <3.12.0）
• mobile_scanner 依赖的MLKit链路要求 Protobuf 版本满足 ~> 3.12（即 >=3.12.0 且 <4.0.0）
  两个约束没有重叠的版本区间，直接执行pod update无法解决问题，因为CocoaPods找不到同时满足两个要求的版本。

方案1：升级/替换依赖插件（优先选择，无长期维护成本） #

原flutter_blue插件已经停止维护多年，其锁定的Protobuf版本和近年更新的MLKit系列库天然冲突，最稳妥的解决方式是替换为社区持续维护的兼容版本：

• 将pubspec.yaml中的flutter_blue替换为最新版flutter_blue_plus（原flutter_blue的社区续更版本，已经放宽Protobuf版本约束，可兼容3.12+版本）
• 执行以下命令完成清理重装：

flutter pub get
cd ios
pod deintegrate
rm -f Podfile.lock
pod install --repo-update

方案2：全局强制指定Protobuf版本（快速验证，适合临时调试） #

Protobuf 3.x 系列版本向下兼容性较好，绝大多数场景下3.12+版本可以正常运行基于3.11版本编译的proto逻辑，可以在Podfile中添加全局版本覆盖，跳过子依赖的版本校验：

1. 打开ios目录下的Podfile，在文件头部添加如下配置：

# 全局指定Protobuf兼容版本
pod 'Protobuf', '~> 3.12'

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)
    # 处理Protobuf头文件引用冲突
    target.build_configurations.each do |config|
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        'GPB_USE_PROTOBUF_FRAMEWORK_IMPORTS=1'
      ]
    end
  end
end

2. 执行清理重装命令：

cd ios
pod deintegrate
rm -f Podfile.lock
pod repo update
pod install

注意：如果安装后运行出现蓝牙相关的序列化/反序列化报错，说明版本不兼容，必须回退使用方案1处理。

方案3：修改本地插件依赖约束（应急使用，不推荐长期维护） #

如果暂时无法替换插件，可以直接修改本地拉取的flutter_blue插件的podspec配置，放宽其Protobuf版本要求：

1. 打开路径 .symlinks/plugins/flutter_blue/ios/flutter_blue.podspec
2. 找到配置行 s.dependency 'Protobuf', '~> 3.11.4'，修改为 s.dependency 'Protobuf', '~> 3.12'
3. 执行方案2中相同的清理重装命令即可

注意：.symlinks目录下的文件会在每次执行flutter pub get时被覆盖重置，该修改仅为临时生效，每次拉取依赖后需要重新调整。

之前操作未生效的常见原因 #

• 未清理旧的锁文件和缓存：CocoaPods会优先读取Podfile.lock中记录的版本快照，仅执行pod update在版本约束本身冲突时不会生效，必须先删除锁文件、执行pod deintegrate清理旧安装记录，更新本地pod源仓库后再重新安装
• 未更新本地CocoaPods源仓库：如果本地源仓库版本过旧，会找不到对应版本的Protobuf包，需要先执行pod repo update拉取最新的源信息

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