Flutter项目CocoaPods报错：路径前缀不一致及冻结字符串问题求助

问题背景 #

维护一个长期运行的Flutter项目，完成Xcode相关配置（多环境flavors、RunnerTests等）后，遭遇无法定位的CocoaPods错误，后续安装流程中断。

核心错误信息 #

.../cocoapods/user_interface/error_report.rb:34:in `force_encoding':
can't modify frozen String (FrozenError)

.../Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/pathname.rb:522:in
`relative_path_from': different prefix: "/" and "Pods" (ArgumentError)

安装失败阶段完整日志 #

Integrating client project

   Integrating target `Pods-Runner` (`Runner.xcodeproj` project)
      CDN: trunk Relative path: CocoaPods-version.yml exists! Returning local because checking is only performed in repo update

Error output from CocoaPods:

    .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/user_interface/error_report.rb:34:in `force_encoding': can't modify frozen String (FrozenError)
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/user_interface/error_report.rb:34:in `report'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/command.rb:66:in `report_error'
        from .../.gem/ruby/2.6.0/gems/claide-1.1.0/lib/claide/command.rb:396:in `handle_exception'
        from .../.gem/ruby/2.6.0/gems/claide-1.1.0/lib/claide/command.rb:337:in `rescue in run'
        from .../.gem/ruby/2.6.0/gems/claide-1.1.0/lib/claide/command.rb:324:in `run'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/command.rb:52:in `run'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/bin/pod:55:in `<top (required)>'
        from /usr/local/bin/pod:23:in `load'
        from /usr/local/bin/pod:23:in `<main>'
    /System/Library/Frameworks/Ruby.framework/Versions/2.6/usr/lib/ruby/2.6.0/pathname.rb:522:in `relative_path_from': different prefix: "/" and "Pods" (ArgumentError)
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator/xcconfig_integrator.rb:162:in `create_xcconfig_ref'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator/xcconfig_integrator.rb:45:in `set_target_xcconfig'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator/xcconfig_integrator.rb:21:in `block (2 levels) in integrate'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator/xcconfig_integrator.rb:20:in `each'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator/xcconfig_integrator.rb:20:in `block in integrate'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator/xcconfig_integrator.rb:19:in `each'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator/xcconfig_integrator.rb:19:in `integrate'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator.rb:561:in `block in integrate!'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/user_interface.rb:64:in `section'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator/target_integrator.rb:560:in `integrate!'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator.rb:146:in `each'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator.rb:146:in `integrate_user_targets'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer/user_project_integrator.rb:73:in `integrate!'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer.rb:929:in `block in integrate_user_project'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/user_interface.rb:64:in `section'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer.rb:925:in `integrate_user_project'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer.rb:185:in `integrate'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/installer.rb:170:in `install!'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/command/install.rb:52:in `run'
        from .../.gem/ruby/2.6.0/gems/claide-1.1.0/lib/claide/command.rb:334:in `run'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/lib/cocoapods/command.rb:52:in `run'
        from .../.gem/ruby/2.6.0/gems/cocoapods-1.13.0/bin/pod:55:in `<top (required)>'
        from /usr/local/bin/pod:23:in `load'
        from /usr/local/bin/pod:23:in `<main>'

已尝试操作 #

• 通过brew、sudo、rbenv等多种方式重装CocoaPods，问题未解决
• 无法确定是CocoaPods安装异常，还是项目历史遗留配置问题

补充更新信息 #

• 项目中未找到Podfile.lock文件
• Podfile内存在一段创建.symlinks文件夹的脚本，该文件夹下有Firebase相关pods：

# Prepare symlinks folder. We use symlinks to avoid having Podfile.lock
  # referring to absolute paths on developers' machines.
  ephemeral_dir = File.join('Flutter', 'ephemeral')
  symlink_dir = File.join(ephemeral_dir, '.symlinks')
  symlink_plugins_dir = File.join(symlink_dir, 'plugins')
  system("rm -rf #{symlink_dir}")
  system("mkdir -p #{symlink_plugins_dir}")

排查解决建议 #

• 彻底清理后重新初始化Pods

  1. 进入iOS目录：cd ios
  2. 删除残留文件：rm -rf Pods Podfile.lock Runner.xcworkspace
  3. 清除Flutter缓存：flutter clean
  4. 重新生成依赖配置：flutter pub get
  5. 执行Pods安装：pod install --repo-update

• 修复路径冲突问题
  手动创建Podfile脚本中指定的目录，避免路径解析错误：

  mkdir -p Flutter/ephemeral/.symlinks/plugins
  

  同时检查Xcode项目Build Settings中的HEADER_SEARCH_PATHS、FRAMEWORK_SEARCH_PATHS，替换所有异常绝对路径为相对路径。

• 调整CocoaPods版本
  当前使用的1.13.0版本与系统Ruby 2.6存在兼容性问题，可尝试：

  • 降级到稳定版：gem install cocoapods -v 1.12.1
  • 升级到最新版：先通过rbenv切换Ruby到2.7+版本，再执行gem install cocoapods

• 检查Xcode Target配置一致性
  打开Runner.xcodeproj，确认Runner和RunnerTests等所有Target的配置项一致，没有遗漏的路径引用或环境变量配置。

内容的提问来源于stack exchange，提问作者JAgüero