react-native-onesignal通知操作按钮在iOS/Android不显示问题求助

针对你遇到的操作按钮不显示的问题，结合OneSignal的官方规范和常见踩坑点，我整理了以下排查和解决思路：

一、先修正请求体的潜在问题 #

你的请求体里有几个可能干扰按钮显示的点，先调整试试：

• 移除顶级的"action": "like-button"字段：这个字段是用来设置通知本身的默认点击动作，和按钮配置共存时可能导致优先级冲突，建议删除。
• 添加iOS类别关联字段：在请求体中加入"ios_category": "news-feature"，这个值要和你iOS客户端注册的通知类别ID一致（后面会说客户端配置），iOS必须通过类别关联才能识别操作按钮。
• 替换按钮图标为HTTPS链接：Android 7.0默认禁止HTTP请求加载资源，你当前用的http://i.imgur.com/...图标会加载失败，导致按钮不显示，换成HTTPS的图标链接（比如https://i.imgur.com/N8SN8ZS.png）。

调整后的请求体核心部分示例：

{
  "app_id": "#########-#########-########",
  "heading": "OneSignal Web Push Notification",
  "contents": { "en": "Action buttons increase the ways your users can interact with your notification." },
  "data": { "notificationType": "news-feature" },
  "url": "https://example.com",
  "icon": "https://onesignal.com/images/notification_logo.png",
  "ios_category": "news-feature", // 新增iOS类别关联
  "buttons": [
    {
      "action": "like-button",
      "title": "Like",
      "icon": "https://i.imgur.com/N8SN8ZS.png", // 换成HTTPS
      "url": "https://example.com"
    },
    {
      "action": "read-more-button",
      "title": "Read more",
      "icon": "https://i.imgur.com/MIxJp1L.png", // 换成HTTPS
      "url": "https://example.com"
    }
  ],
  "include_player_ids": [ "######-###################-#####", "######-###################-#####" ]
}

二、平台专属配置检查 #

Android 7.0 端 #

1. SDK版本兼容性：确保你集成的OneSignal Android SDK版本不低于3.x，旧版本在Android N上对操作按钮的支持有缺陷。
2. 通知图标规范：按钮图标必须符合Android通知图标要求——白色透明背景的矢量图（或png），不能用彩色图标，否则系统会自动隐藏。
3. 网络权限配置：如果必须用HTTP图标，需要在AndroidManifest.xml的<application>标签中添加android:usesCleartextTraffic="true"，允许明文请求。

iOS 11.2.1 端 #

iOS的操作按钮依赖**通知类别（Notification Category）**的注册，这是最容易遗漏的点：

1. 在客户端注册类别：在AppDelegate的didFinishLaunchingWithOptions方法中，注册包含对应action的通知类别，示例代码（Swift）：

import UserNotifications

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 初始化OneSignal后，注册通知类别
    let likeAction = UNNotificationAction(identifier: "like-button", title: "Like", options: [])
    let readMoreAction = UNNotificationAction(identifier: "read-more-button", title: "Read more", options: [])
    let category = UNNotificationCategory(identifier: "news-feature", actions: [likeAction, readMoreAction], intentIdentifiers: [], options: [])
    UNUserNotificationCenter.current().setNotificationCategories([category])
    
    return true
}

注意：类别IDnews-feature必须和请求体中ios_category的值完全一致。
2. 权限检查：确保用户授予了通知权限，并且没有在系统设置中关闭通知的“操作按钮”显示（iOS默认开启，但可以手动关闭）。

三、调试与验证步骤 #

1. 查看OneSignal控制台日志：发送通知后，在OneSignal控制台的通知详情页，切换到Delivery标签，查看是否有关于按钮加载失败的错误提示（比如图标加载失败、类别不匹配）。
2. 客户端日志排查：
   • Android：用Logcat过滤OneSignal标签，查看是否有按钮初始化失败的日志信息。
   • iOS：用Xcode控制台过滤OneSignal或UserNotifications关键词，检查类别注册是否成功、通知是否关联了正确的类别。
3. 简化测试：发送一个只包含app_id、contents、buttons、include_player_ids的极简请求，排除其他字段的干扰，验证按钮是否能正常显示，再逐步添加其他字段排查问题。

四、OneSignal控制台发送的注意事项 #

如果用控制台发送测试通知，需要：

• 在Options -> Action Buttons中正确添加按钮的Action ID和Title。
• 在iOS Options中指定Category ID，对应你客户端注册的类别ID。
• 在Android Options中确保按钮图标是HTTPS链接，符合通知图标规范。

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