Flutter执行build ios命令卡在Compiling, linking and signing阶段如何解决

故障现象 #

执行iOS打包命令flutter build ios时进程长时间停滞，Pod安装完成后始终无法走完构建流程，命令行固定输出如下内容无后续进展：

Running pod install...                                           2,087ms
Running Xcode build...                                                  
 └─Compiling, linking and signing...                            ⣻

排查解决步骤 #

• 优先通过Xcode直接构建定位问题
  命令行模式下Flutter会吞掉Xcode构建的大部分实时日志，很多卡死场景本质是有交互弹窗或者隐藏报错没有展示。直接进入项目的ios目录，双击打开Runner.xcworkspace，在Xcode中选中对应构建目标（真机/Generic iOS Device），点击菜单栏Product > Build触发构建，就能看到具体卡点：常见的有首次启动Xcode未同意用户协议、钥匙串签名证书需要手动授权、依赖库编译报错这类问题，在Xcode里把提示的问题处理完，再回到命令行执行构建即可恢复正常。
• 清理全量缓存后重新构建
  缓存损坏是这类无报错卡死的高频诱因，依次执行以下命令清理所有构建缓存、重装iOS依赖：

  flutter clean
  cd ios
  rm -rf Pods Podfile.lock build
  pod deintegrate
  pod install --repo-update
  cd ..
  flutter build ios
  

  M系列芯片Mac如果执行pod命令报架构相关错误，在pod命令前加arch -x86_64前缀，通过Rosetta转译运行即可。
• 校验签名配置有效性
  打开Xcode中Runner项目的Signing & Capabilities标签页，确认选中的开发团队、签名证书、Bundle ID均无红色报错提示。如果证书过期、描述文件不匹配、钥匙串中的证书未被设为信任，签名环节会无提示卡住——在Xcode中触发一次构建，弹出钥匙串访问授权时输入系统密码选择始终允许，完成授权后后续命令行构建就不会卡在签名步骤。
• 排查大体积资源编译耗时
  如果项目中内置了单个体积超过1G的未压缩素材、动态库，Xcode的资源压缩、链接步骤耗时会大幅增加，看起来和卡死无异。可以在Xcode的构建日志导航栏查看实时构建进度，确认是否正在处理大体积文件，这类大资源建议提前做压缩处理，或改为应用安装后动态下载。
• 校验开发环境版本匹配
  执行flutter doctor查看环境检测结果，确认没有Flutter与Xcode版本不兼容的提示。如果刚升级过Xcode，先执行以下命令切换命令行工具路径、同意最新的Xcode许可协议：

  sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
  sudo xcodebuild -license accept
  

  执行完成后重新触发构建即可。

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