Flutter使用云函数实现iOS推送无响应 Android运行正常问题求助

1 首要代码问题修复 #

你当前的main.dart仅为Android平台做了Firebase初始化，iOS平台未执行初始化逻辑，这是导致iOS推送无法接收的核心原因之一，请按如下代码修正：

void main() async => {
      WidgetsFlutterBinding.ensureInitialized(),
      // 全平台初始化Firebase，去掉仅Android的判断
      await Firebase.initializeApp(),
      SystemChrome.setPreferredOrientations([DeviceOrientation.portraitUp])
          .then(
        (_) {
          runApp(const MyApp());
        },
      )
    };

class MyApp extends StatelessWidget {
  const MyApp({super.key});
  
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      debugShowCheckedModeBanner: false,
      home: const Splash(),
      theme: ThemeData(accentColor: Colors.black38),
    );
  }
}

2 客户端基础配置排查 #

• 确认Xcode项目中已开启两项能力：Signing & Capabilities下添加Push Notifications，添加Background Modes并勾选Remote notifications
• 确认已将Firebase生成的GoogleService-Info.plist文件通过Xcode导入到iOS项目中，而非仅拷贝到文件夹目录
• 确认苹果开发者账号中已生成对应应用的推送证书/APNs认证密钥，且已将正确的密钥/证书上传到Firebase控制台的Cloud Messaging设置中

3 权限与注册逻辑排查 #

• 确认代码中已主动申请iOS通知权限，需调用系统通知授权接口请求用户同意接收通知，未授权的设备无法收到任何推送
• 确认APNs device token注册逻辑已正常执行，拿到的token已正确上传到你的云函数/推送服务后台，token失效或未上传都会导致推送无法送达

4 推送格式与环境排查 #

• 检查云函数的推送 payload 是否适配iOS规范：iOS推送必须包含aps字段，字段内需包含alert、sound等推送展示必需的内容，仅适配Android格式的payload无法被iOS系统识别
• 确认推送环境匹配：测试阶段用debug包时需对应APNs沙箱环境，正式release包需对应APNs生产环境，环境不匹配会导致推送被APNs服务器拒收

5 调试验证 #

• 优先使用Firebase控制台的「发送测试消息」功能，直接填入iOS设备的APNs token发送测试推送，先排除云函数逻辑错误的可能性
• Xcode运行项目时查看控制台日志，确认是否有推送注册失败、权限被拒绝、token获取失败等相关报错，可快速定位问题根因

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