升级macOS 14后构建Flutter应用遇Command CodeSign失败求助

问题现象 #

升级至 macOS 14 后，使用 Flutter 构建 iOS 应用持续报错：

[ +100 ms] Failed to build iOS app
[ +6 ms] Uncategorized (Xcode): Command CodeSign failed with a nonzero exit code
[ +8 ms] Could not build the application for the simulator.
Error launching application on iPhone 15 Pro.
[ +18 ms] "flutter run" took 95,168ms.
[ +15 ms]
#0 throwToolExit (package:flutter_tools/src/base/common.dart:10:3)
#1 RunCommand.runCommand (package:flutter_tools/src/commands/run.dart:760:9)
#2 FlutterCommand.run. (package:flutter_tools/src/runner/flutter_command.dart:1297:27)
#3 AppContext.run. (package:flutter_tools/src/base/context.dart:150:19)
#4 CommandRunner.runCommand (package:args/command_runner.dart:212:13)
#5 FlutterCommandRunner.runCommand. (package:flutter_tools/src/runner/flutter_command_runner.dart:339:9)
#6 AppContext.run. (package:flutter_tools/src/base/context.dart:150:19)
#7 FlutterCommandRunner.runCommand (package:flutter_tools/src/runner/flutter_command_runner.dart:285:5)
#8 run.. (package:flutter_tools/runner.dart:115:9)
#9 AppContext.run. (package:flutter_tools/src/base/context.dart:150:19)
#10 main (package:flutter_tools/executable.dart:90:3)
[ +264 ms] ensureAnalyticsSent: 252ms
Running 1 shutdown hook
[ +10 ms] Shutdown hooks complete
exiting with code 1

flutter doctor 检测结果：

Doctor summary (to see all details, run flutter doctor -v):
Flutter (Channel stable, 3.13.8, on macOS 14.0 23A344 darwin-x64, locale en-US)
Android toolchain - develop for Android devices (Android SDK version 34.0.0)
Xcode - develop for iOS and macOS (Xcode 15.0.1)
Chrome - develop for the web
Android Studio (version 2022.3)
VS Code (version 1.83.1)
VS Code (version 1.83.1)
Connected device (3 available)
Network resources

已尝试操作：

• 创建并运行空白应用（Xcode 可成功运行但 VS Code 中失败）
• 锁定并解锁钥匙串访问
• 移除项目中所有扩展属性
• 重装 VS Code
• 执行 flutter clean

排查与解决方法 #

1. 检查 VS Code 终端权限 #

Xcode 正常但 VS Code 失败，优先排查权限问题：

• 打开「系统设置」→「隐私与安全性」→「完全磁盘访问权限」
• 确认 VS Code、终端（Terminal/iTerm）已添加并勾选权限
• 重启 VS Code 后重新执行 flutter run

2. 调整 Xcode 签名配置 #

Xcode 15 对签名验证更严格，即使模拟器运行也需确认配置：

• 打开项目 ios/Runner.xcodeproj，选择 Runner 目标
• 进入「Signing & Capabilities」，确保「Automatically manage signing」已勾选，团队选择正确（个人团队也可）
• 切换到「Build Settings」，搜索 CODE_SIGN_STYLE，确认设置为 Automatic
• 关闭 Xcode，在终端执行 flutter run 测试

3. 升级 Flutter 版本适配 Xcode 15 #

Flutter 3.13.8 与 Xcode 15 存在兼容性问题，升级至最新稳定版：

flutter channel stable
flutter upgrade
flutter clean
flutter pub get
flutter run

4. 重置钥匙串签名条目 #

若钥匙串权限仍异常：

• 打开「钥匙串访问」，删除过期/无效的「iOS Developer」相关证书
• 重新从 Apple Developer 平台下载安装证书
• 可执行 security delete-keychain login.keychain-db（注意备份重要证书），重启电脑后重新登录开发者账号

5. 更新 VS Code Flutter 插件 #

确保插件为最新版本：

• 在 VS Code 插件市场搜索「Flutter」，点击「更新」
• 重启 VS Code 后尝试构建

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