Flutter iOS应用无法接收推送通知问题排查求助

核心问题定位 #

你遇到的问题根源很明确：TestFlight属于生产环境，但本地Runner.entitlements中aps-environment设置为development，加上Fastlane签名时的环境不匹配，导致应用没有正确的推送权限，控制台日志No valid 'aps-environment' entitlement string found直接佐证了这一点。

分步解决方案 #

1. 修正本地Entitlements配置 #

打开myapp/ios/Runner/Runner.entitlements，将aps-environment的值修改为production：

<key>aps-environment</key>
<string>production</string>

注意：本地调试（Xcode直接运行到设备）时需要改回development，生产构建（TestFlight/正式上架）再切换为production。

2. 检查Fastlane签名配置 #

Fastlane构建时容易出现环境不匹配的问题，需要确认以下配置：

• 若使用match管理签名，拉取生产环境签名时要指定type: "appstore"：

  match(type: "appstore")
  

• 若使用gym构建，确保export_method设置为app-store（TestFlight构建用这个）：

  gym(
    export_method: "app-store",
    # 其他配置...
  )
  

• 检查Fastfile中是否有自动替换aps-environment的脚本，避免构建时被覆盖。

3. 重新生成并验证签名文件 #

• 登录Apple开发者后台，确认App ID已开启推送权限，且生产环境的APNs密钥/证书有效；
• 用Fastlane重新拉取生产签名：

  fastlane match appstore
  

• 构建完成后，右键IPA包选择"显示包内容"，检查embedded.mobileprovision和Runner.entitlements中的aps-environment均为production。

4. 重新测试推送 #

• 上传新的TestFlight构建，安装后获取新的FCM Token（环境变更后Token会更新）；
• 在Firebase控制台创建推送活动时，确保目标是生产环境设备（TestFlight属于生产环境）。

补充说明 #

• 自动生成的AppDelegate.swift无需修改，Flutter Firebase Messaging已集成必要的推送注册逻辑；
• 控制台出现的Push registration with a nil environment等日志，都是aps环境配置错误导致的推送注册失败，解决环境问题后会自动消失。

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