GitHub Actions构建Flutter iOS报错：找不到开发描述文件

核心原因 #

1. ExportOptions.plist 配置与准备的描述文件不匹配 #

flutter build ipa 完全遵循 ExportOptions.plist 的配置逻辑。如果你的 plist 里 method 设为 development 或 ad-hoc，但仅上传了 App Store 分发描述文件，Xcode 会强制寻找对应 Bundle ID 的开发/测试描述文件，自然找不到匹配项。另外，若 provisioningProfiles 字段指定了特定类型的描述文件名称，也会导致 Xcode 忽略你上传的分发版描述文件。

2. Dev Flavor 的 Bundle ID 与分发描述文件不对应 #

你的 dev flavor 大概率使用了和正式版不同的 Bundle ID（比如 com.yourapp.dev），但你上传的分发描述文件对应的是正式版 com.yourapp，Xcode 找不到 com.yourapp.dev 的分发描述文件，就会报错要求开发版描述文件。

3. GitHub Actions 中描述文件配置错误 #

你上传的是分发描述文件，但 Actions 脚本可能未将其放置到正确路径，或者描述文件的类型（开发/分发）与 Xcode 构建需求不匹配。

解决步骤 #

1. 修正 ExportOptions.plist 配置 #

打开 ios/Runner/ExportOptions.plist，重点检查以下字段：

• method：要发布到 App Store 就设为 app-store，Ad-hoc 测试设为 ad-hoc，仅开发测试才设为 development，必须与你准备的描述文件类型一致。
• provisioningProfiles：确保其中的 Bundle ID（比如 com.yourapp.dev）对应的值是你上传的分发描述文件的完整名称。示例 App Store 分发配置：

<key>provisioningProfiles</key>
<dict>
  <key>com.yourapp.dev</key>
  <string>你的Dev环境App Store分发描述文件名称</string>
</dict>
<key>method</key>
<string>app-store</string>

2. 对齐 Flavor 的 Bundle ID 与描述文件 #

打开 ios/Runner.xcworkspace，切换到 dev flavor，进入 Build Settings 查看 Product Bundle Identifier，必须与你上传的分发描述文件中的 Bundle ID 完全一致。若不一致，要么修改 Xcode 中的 Bundle ID，要么去 Apple 开发者后台重新生成对应 Bundle ID 的分发描述文件。

3. 修正 GitHub Actions 中的描述文件配置 #

确保 Actions 脚本将分发描述文件放置到正确路径：

- name: 安装分发描述文件
  run: |
    mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles
    echo "${{ secrets.IOS_DISTRIBUTION_PROFILE }}" | base64 --decode > ~/Library/MobileDevice/Provisioning\ Profiles/dev-distribution.mobileprovision

同时确认描述文件是 App Store Distribution 或 Ad-hoc Distribution 类型，而非开发版。

4. 确认证书与描述文件绑定正确 #

登录 Apple 开发者后台查看分发描述文件详情，确保其中包含你上传的 p12 证书的公钥。若未绑定，重新生成描述文件并关联正确的证书。

额外排查技巧 #

• 执行 flutter build ipa 时添加 -v 参数，查看详细日志，明确 Xcode 正在寻找的描述文件类型及对应 Bundle ID。
• 在 GitHub Actions 虚拟环境中运行 security find-identity -v -p codesigning，确认 p12 证书已正确导入。
• 检查 Apple 开发者后台，确认对应 Bundle ID 的分发描述文件未过期、关联的证书未失效。

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