Flutter iOS项目集成Firebase Cloud Messaging推送通知无响应问题求助

阿华AIGC实验室

2026-4-28

解决Flutter iOS项目FCM推送无响应的问题

结合你描述的情况——全新项目能正常配置推送，克隆的旧项目不行，说明你的本地开发环境（Xcode、Flutter、Firebase工具链）是没问题的，问题大概率出在旧项目的配置遗漏或签名/证书相关细节上。我给你梳理几个关键排查和修复步骤：

1. 先确认Firebase基础配置是否正确

检查GoogleService-Info.plist：确保它是通过Xcode拖入Runner目录的（不是直接复制到文件夹），这样才能被Xcode正确识别引用。对比新项目的同文件，看看旧项目的文件里aps-environment字段是否存在，以及Team ID、Bundle ID是否和你的开发者账号匹配。

确认iOS端初始化代码：打开ios/Runner/AppDelegate.swift，检查是否导入了Firebase并完成初始化：

import Firebase

override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
  FirebaseApp.configure()
  // 其他代码...
  return true
}

2. 解决`aps-environment`键找不到的问题

这个键是Xcode根据你的推送能力配置自动生成的，不需要手动添加，但如果没自动生成，按以下步骤处理：

打开Xcode，选中Runner Target → 切换到Signing & Capabilities标签页，点击+ Capability，添加Push Notifications能力。添加后Xcode会自动在Provisioning Profile中启用推送权限，同时生成aps-environment键。
如果添加能力后还是看不到该键，手动编辑Info.plist：右键Info.plist选择Open As → Source Code，插入以下代码：
```
<key>aps-environment</key>
<string>development</string> 
```
检查Provisioning Profile：登录Apple Developer后台，确认你正在使用的Profile已经勾选了Push Notifications服务，并且和项目的Bundle ID、Team ID完全匹配。

3. 检查Flutter端FCM配置和权限请求

确认pubspec.yaml中firebase_messaging的版本和你能正常工作的新项目一致，避免版本兼容问题，执行flutter pub get更新依赖。

确保你在Flutter代码中请求了推送权限：

void requestNotificationPermission() async {
  NotificationSettings settings = await FirebaseMessaging.instance.requestPermission(
    alert: true,
    badge: true,
    sound: true,
  );
  if (settings.authorizationStatus == AuthorizationStatus.authorized) {
    print("用户已授权推送权限");
  }
}

测试时确认iOS设备的App推送权限已开启：进入设置 → 你的App → Notifications，确保允许通知的开关是打开的。

4. 按正确顺序执行清理重建

你之前做了很多清理操作，但顺序可能影响效果，建议按以下步骤重新执行：

# 1. 清理Flutter项目缓存
flutter clean

# 2. 进入iOS目录
cd ios

# 3. 删除Pods和锁文件
rm -rf Pods Podfile.lock

# 4. 清理Pod缓存
pod cache clean --all

# 5. 更新Pod仓库
pod repo update

# 6. 重新安装Pods
pod install

# 7. 返回项目根目录并运行
cd ..
flutter run