使用fastlane上传Flutter应用至Firebase App Distribution时IPA未上传问题

问题原因 #

• 控制台筛选条件错误：Firebase App Distribution列表默认可能设置了应用类型、时间范围的筛选，仅展示APK类型的包，iOS包被过滤隐藏。
• 版本标识未更新：首次上传成功后，后续打包的IPA没有提升version（版本号）或build（构建号），Firebase App Distribution默认会隐藏同一应用、同一版本标识的重复上传包，仅保留首次上传的记录，因此后续上传成功也不会在列表展示。
• 上传目标配置错误：后续部署时fastlane配置的Firebase iOS应用ID、Bundle ID与实际打包的IPA不匹配，或使用了错误的Firebase项目凭证，导致IPA被上传到了其他Firebase项目/应用下，当前项目看不到。
• 发布审核拦截：项目开启了App Distribution的上传审核策略，IPA包上传后进入待审核状态，未通过审核前不会公开展示在分发列表中。
• 插件兼容性bug：使用的fastlane-plugin-firebase_app_distribution版本过旧，存在iOS上传状态误报的已知问题，实际上传未完成但终端返回成功标识。
• IPA包格式异常：后续打包的IPA未正确签名、包含损坏的资源文件，或者是模拟器架构包，Firebase后台校验不通过自动隐藏，仅返回上传成功的表面响应。

修复方案 #

• 检查控制台筛选规则：先确认Firebase App Distribution页面顶部的筛选栏，应用类型选择了「全部」或者「iOS」，时间范围覆盖IPA上传的时间区间，排除过滤规则导致的包不可见。
• 强制更新版本标识：每次打包IPA前提升build号，Flutter项目可以直接修改pubspec.yaml中版本号后缀的构建号（如version: 1.0.0+1中的+1每次上传前递增），也可以在fastlane的iOS打包脚本中添加自动递增逻辑：

# 插入到Fastfile iOS打包步骤前
increment_build_number(xcodeproj: "Runner.xcodeproj")

• 核对上传配置：确认fastlane中firebase_app_distribution动作的app参数，和Firebase控制台中对应iOS应用的应用ID完全一致；同时校验打包生成的IPA的Bundle ID，和Firebase iOS应用登记的Bundle ID匹配，使用的服务账号凭证归属当前项目。
• 检查发布审核状态：进入Firebase App Distribution的「审核」标签页，查看是否有IPA包处于待审核/被驳回状态，调整审核规则或手动通过审核即可正常展示。
• 升级插件版本：执行命令更新fastlane的Firebase分发插件到最新版，修复已知兼容性问题：

fastlane add_plugin firebase_app_distribution

• 校验IPA合法性：本地手动导出IPA包，直接上传到Firebase App Distribution后台，确认可以正常展示，排查是否是打包脚本导致的IPA损坏、签名错误问题。

问题相关截图 #

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