Codemagic构建的Flutter应用已上传App Store Connect但TestFlight无构建版本咨询

所有配置符合官方要求的前提下出现该问题，核心原因是苹果后台对上传包的自动校验未通过，校验失败的包不会被同步到TestFlight列表，可按以下优先级排查：

1. 校验失败邮件核查 #

开发者账号绑定的注册邮箱会收到苹果的官方校验失败通知，邮件内会明确标注具体错误项，可优先查看该邮件定位问题，常见错误包括权限描述缺失、SDK合规问题、版本号冲突、签名类型错误。

2. 版本号与构建号校验 #

• Flutter项目pubspec.yaml的版本规则为营销版本号+内部构建号，格式如1.1.0+2，需确认本次上传的内部构建号（即+后的数字）未在App Store Connect当前营销版本下使用过，重复的构建号会被苹果直接过滤，不会展示。
• 检查Codemagic构建配置中是否存在自动生成构建号的逻辑，可在构建日志的Xcode构建阶段搜索MARKETING_VERSION（营销版本号）、CURRENT_PROJECT_VERSION（内部构建号），确认实际打包使用的版本参数和预期一致。

3. 签名与项目配置核查 #

• 确认打包使用的是App Store分发证书，开发证书、Ad Hoc证书也能完成上传步骤，但会被后台校验拦截，无法进入TestFlight列表。
• 核查Info.plist的权限描述完整性，所有调用的系统权限（相机、定位、相册等）都需要添加对应的权限说明文本，缺失说明的包会被直接打回。
• 若项目包含App扩展（通知扩展、Widget组件等），需保证所有扩展的营销版本号、内部构建号和主App完全一致，版本不匹配会导致整包校验失败。

4. 上传环节隐性错误核查 #

• 查看Codemagic上传阶段的完整日志，部分不阻断上传流程的警告会触发后台拦截，最常见的是出口合规配置缺失，可在Info.plist中添加ITSAppUsesNonExemptEncryption字段，值设为false（应用不涉及加密场景时）规避该问题。
• 确认打包使用的Bundle ID和App Store Connect中对应应用的Bundle ID完全一致，大小写、特殊字符的差异都会导致包被匹配到错误的应用项下。

5. 后台同步延迟处理 #

苹果后台存在偶发的同步延迟，新上传的构建包最长可能需要2小时才能同步到TestFlight列表，若刚上传完成可等待1-2小时后再核查。

内容的提问来源于stack exchange，提问作者Иван Мороз