Flutter中OneSignal通知点击监听器无法正常工作

排查步骤及修复方案 #

1. 确认初始化时机正确 #

确保initializeOneSignal在Flutter绑定初始化完成后调用，且在runApp之前执行：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await initializeOneSignal();
  runApp(const MyApp());
}

2. 检查Android端配置完整性 #

OneSignal v5.x需要确保Android项目配置无遗漏：

• 在android/build.gradle中添加OneSignal Gradle插件：

  buildscript {
    dependencies {
      classpath 'com.onesignal:onesignal-gradle-plugin:[0.14.0, 0.99.99]'
    }
  }
  

• 在android/app/build.gradle顶部应用插件：

  apply plugin: 'com.onesignal.androidsdk.onesignal-gradle-plugin'
  

• 确保AndroidManifest.xml禁用默认通知打开行为（避免冲突）：

  <meta-data android:name="com.onesignal.NotificationOpened.DEFAULT" android:value="DISABLE" />
  

3. 调整监听器注册顺序 #

将监听器注册放在权限请求之前，避免权限请求阻塞导致注册延迟：

Future<void> initializeOneSignal() async {
  OneSignal.initialize(oneSignalAppId);
  
  // 先注册监听器
  OneSignal.Notifications.addForegroundWillDisplayListener((event) {
    debugPrint("[OneSignal] Foreground Notification received");
  });

  OneSignal.Notifications.addClickListener((event) {
    final actionId = event.result.actionId;
    if (actionId == "approve_action") {
      debugPrint("[OneSignal] Approve Button Clicked");
    } else if (actionId == "dismiss_action") {
      debugPrint("[OneSignal] Dismiss Button Clicked");
    } else {
      debugPrint("[OneSignal] Unknown button clicked: $actionId");
    }
  });

  // 再请求权限
  await checkAndRequestNotificationPermission();
}

4. 验证通知按钮Action ID一致性 #

登录OneSignal控制台，检查发送通知时配置的按钮Action ID是否与代码中的字符串完全一致（区分大小写、无拼写错误）。

5. 排查SDK版本兼容性 #

当前Flutter 3.7.9与OneSignal 5.2.9可能存在适配问题，尝试升级OneSignal SDK到最新稳定版：

flutter pub upgrade onesignal_flutter

6. 原生层调试确认事件传递 #

在Android原生项目中添加日志，验证OneSignal事件是否传递到Flutter：

• 打开android/app/src/main/kotlin/[包名]/MainActivity.kt，添加原生监听：

  import com.onesignal.OneSignal
  import com.onesignal.notifications.INotificationClickListener
  import android.util.Log
  
  class MainActivity : FlutterActivity() {
      override fun onCreate(savedInstanceState: Bundle?) {
          super.onCreate(savedInstanceState)
          OneSignal.Notifications.addClickListener(object : INotificationClickListener {
              override fun onClick(event: INotificationClickEvent) {
                  Log.d("OneSignalNative", "Notification clicked, actionId: ${event.result.actionId}")
              }
          })
      }
  }
  

  若原生能打印日志但Flutter端无输出，执行以下命令重置插件：

  flutter clean
  flutter pub get
  

7. 检查应用状态下的事件处理 #

• 前台状态：若addForegroundWillDisplayListener也无法触发，说明初始化存在根本问题；
• 后台/杀死状态：检查AndroidManifest.xml中的启动模式（如singleInstance可能导致事件传递失败），确保应用能被正常唤醒并传递事件。

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