PubNub iOS推送消息无法送达APNs问题排查求助

问题背景 #

我开发了一个.NET API，用于将移动设备注册到PubNub频道并发送推送通知：

• 设备注册代码执行后返回200，无错误：

_pubNub.AddPushNotificationsOnChannels()
    .PushType(PNPushType.APNS2)
    .Channels(new string[] {
       device.ChannelId.ToString()
    })
    .DeviceId(device.DeviceId)
    .Topic(_settings.ApplicationBundle)
    .Environment(device.Enviroment)
    .Execute(new AddDevicePushChannel());

• 发送通知代码同样返回200无错误，但通知始终无法送达APNs：

_pubNub.Publish()
.Channel(message.ChannelId.ToString())
.Message(new string[] {
      message.Text
})
.Execute(new PushPublishMessageChannel());

已完成的验证：

• 设备已成功加入目标频道
• 通过APNs控制台直接向该DeviceId发送推送可正常接收
• PubNub的iOS通知配置（含*.p8文件）已正确设置
• 已尝试修改Payload格式，仍无效：

Dictionary<string, object> apnsData = new Dictionary<string, object>
{
    {
       "aps", new Dictionary<string, string>() {
            {
               "alert","Hello"
            }
    }
    }
};

MobilePayload mobilePayload = new MobilePayload();
mobilePayload.pn_apns = apnsData;

_pubNub.Publish()
    .Channel(message.ChannelId.ToString())
    .Message(mobilePayload)
    .Execute(new PushPublishMessageChannel());

排查建议 #

• 验证APNs Payload规范完整性
  PubNub传递给APNs的Payload必须严格符合Apple的推送规范，除了aps字段，建议补充sound（如"sound": "default"）等基础字段，避免APNs因字段缺失拒收。同时检查MobilePayload是否需要显式设置pn_push标记，部分SDK版本要求明确声明这是推送通知。

• 核对环境配置一致性
  确认设备注册时传入的device.Enviroment（开发/生产）与PubNub后台配置的APNs环境、设备当前运行环境完全匹配。例如设备处于调试模式（开发环境），但PubNub配置为生产APNs，会导致推送无法送达。

• 查看PubNub推送日志
  登录PubNub控制台，进入推送通知的交付日志（Push Notifications > Delivery Logs），这里会记录PubNub向APNs发送请求的详细状态，包括APNs返回的错误码（如BadDeviceToken、InvalidTopic），即使API返回200，也可能存在下游推送失败的记录。

• 校验DeviceToken格式
  确认传入PubNub的device.DeviceId是APNs认可的有效令牌：64位十六进制字符串，无空格或多余字符。令牌格式错误可能导致PubNub注册成功，但向APNs发送时失败。

• 升级PubNub .NET SDK版本
  检查当前使用的SDK是否为最新稳定版，部分旧版本存在APNs2 Payload封装的bug，升级后可能解决推送传递问题。

• 确认频道名称完全匹配
  检查发送通知的message.ChannelId.ToString()与注册时的device.ChannelId.ToString()是否完全一致（频道名称大小写敏感），名称不匹配会导致设备收不到对应频道的推送。

• 测试原始Payload格式
  尝试直接传递符合APNs规范的完整字典作为Message，跳过MobilePayload封装，排查封装类可能存在的问题：

var payload = new Dictionary<string, object>
{
    ["pn_apns"] = new Dictionary<string, object>
    {
        ["aps"] = new Dictionary<string, object>
        {
            ["alert"] = new Dictionary<string, string>
            {
                ["title"] = "测试标题",
                ["body"] = "测试内容"
            },
            ["sound"] = "default"
        }
    }
};

_pubNub.Publish()
    .Channel(message.ChannelId.ToString())
    .Message(payload)
    .Execute(new PushPublishMessageChannel());

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