Flutter（Android）中OneSignal推送通知异常的排查求助

问题背景 #

已完成OneSignal控制台配置及Firebase集成，使用Flutter 3.22.3 + onesignal_flutter ^5.2.9，但应用既不弹出通知权限请求弹窗，也无法接收推送通知，反复检查配置仍未解决。

可能的问题及排查方向 #

1. OneSignal初始化与权限请求时机不匹配 #

新版onesignal_flutter的initialize方法是异步操作，原代码同步调用权限请求可能导致SDK未初始化完成就触发请求，进而无响应。

修改方案：将配置方法改为异步，等待初始化完成后再请求权限：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  await Firebase.initializeApp();
  await configureOneSignal();

  runApp(const MyApp());
}

Future<void> configureOneSignal() async {
  OneSignal.Debug.setLogLevel(OSLogLevel.verbose);
  
  // 等待OneSignal初始化完成
  await OneSignal.initialize("b38128ff-0561-499c-ab67-87fb6c3b9911");

  final granted = await OneSignal.Notifications.requestPermission(true);
  debugPrint(granted ? "通知权限已授予" : "通知权限被拒绝");
}

2. 平台权限配置遗漏 #

Android端（尤其是Android 13+）

• 检查AndroidManifest.xml是否添加必要权限：

  <uses-permission android:name="android.permission.INTERNET" />
  <!-- Android 13及以上必须添加 -->
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  

• 确认已配置OneSignal的服务与接收器：

  <service android:name="com.onesignal.OneSignalService" />
  <receiver android:name="com.onesignal.GcmBroadcastReceiver" android:permission="com.google.android.c2dm.permission.SEND">
      <intent-filter>
          <action android:name="com.google.android.c2dm.intent.RECEIVE" />
          <category android:name="${applicationId}" />
      </intent-filter>
  </receiver>
  

iOS端

• 检查Info.plist是否添加通知描述与后台模式：

  <key>NSNotificationUsageDescription</key>
  <string>需要通知权限接收推送消息</string>
  <key>UIBackgroundModes</key>
  <array>
      <string>remote-notification</string>
  </array>
  

• 在Xcode的Signing & Capabilities中确认已开启Push Notifications能力，且Bundle ID与OneSignal控制台一致。

3. 权限状态已被永久拒绝 #

如果用户之前手动拒绝过通知权限，系统不会再次自动弹出请求弹窗。可以先检查当前权限状态：

OneSignal.Notifications.permissionStatus().then((status) {
  debugPrint("当前权限状态: ${status.status}");
});

若状态为denied，需引导用户前往系统设置手动开启权限。

4. Firebase集成配置错误 #

• 确认google-services.json（Android）或GoogleService-Info.plist（iOS）的包名/Bundle ID与项目完全匹配。
• 检查Firebase控制台是否开启Cloud Messaging，并将Firebase的服务器密钥正确同步到OneSignal控制台的Firebase配置项中。

5. 日志排查定位问题 #

代码中已开启verbose日志，查看控制台输出的OneSignal相关日志，重点关注：

• 初始化是否成功（搜索"Initialization successful"）
• 是否有无效App ID、网络请求失败、设备注册失败等错误提示
• 权限请求的触发与响应日志

6. 依赖版本兼容性问题 #

检查onesignal_flutter ^5.2.9与Flutter 3.22.3的兼容性，若存在版本冲突，尝试升级或降级onesignal_flutter到官方推荐的兼容版本。

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