您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

APNS 推送失敗排查:Payload 256 bytes 上限引發的靜默錯誤

編輯:iOS 開發綜合

加了 badge 之後推送就完全不來,而且伺服器端沒有任何錯誤訊息——這類「什麼都對卻收不到」的狀況,十次有八次是 Payload 超過了長度上限。

問題描述

需求是在既有推送中加上未讀數量(badge)。文件查到了 badge 的寫法,加上去之後卻怎麼推都推不到,也沒有錯誤回報,卡了很久。

真正的原因

Payload 最多 256 bytes。

APNS 對通知內容的大小有硬性限制。早期的限制是 256 bytes,後來放寬到 2KB(iOS 8 之後)乃至 4KB,但無論上限是多少,超出即被丟棄且不回傳明確錯誤,這正是它難以排查的原因。

怎麼量

用 UTF-8 編碼取得位元組數,而不是字元數:

NSData *data = [payload dataUsingEncoding:NSUTF8StringEncoding];
NSLog(@"payload 長度:%lu bytes", (unsigned long)data.length);

Java 端則是 payload.getBytes("UTF-8").length。

這裡有個關鍵陷阱:中文字元在 UTF-8 中佔 3 個 bytes。原本的通知內文約 240 個字元,看起來沒超過 256,換算成位元組卻已經超標。反覆測試後確認,即使位元組數剛好卡在邊界也可能失敗,因此最好留出餘裕。

對比:精簡前與精簡後

原本(250 bytes,含中文而實際超標)

{"loginUri":"https://192.168.1.8:8086/admin/msm/login",
 "messageID":"580",
 "aps":{"alert":"鄭子宣向你發送了一個工作事項","sound":"default","badge":5},
 "uri":"https://192.168.1.8:8086/admin/msm/login?module=WEIBO&moduleId=93f7cf993df34d3dbc1681f08cced08c"}

精簡後(187 bytes,推送成功)

{"messageID":"608",
 "aps":{"alert":"鄭子宣向你發送了一個工作事項","sound":"default"},
 "uri":"https://192.168.1.8:8086/admin/msm/login?module=WEIBO&moduleId=caedadfd80f841538a3414ca737c2ab0"}

做法是移除 payload 中冗長的 loginUri 欄位,並把 badge 交由 App 端自行計算。

根本的解法

削減欄位只是應急,真正該做的是改變設計思路:

  • 通知只放識別碼,不放內容。Payload 裡只帶 messageID 這類短小的 key,App 收到後再呼叫自己的 API 拉取完整資料。這同時避免了個資外洩在通知中心。
  • 不要在 payload 塞完整 URL。把跳轉用的 URI 換成短碼或路由名稱,由 App 組裝成完整網址。
  • badge 由 App 端維護。伺服器推送一個絕對值容易與本地狀態不同步,改用同步機制較可靠。
  • 改用新的 API。若使用 HTTP/2 的推送介面,記得在請求標頭帶上 apns-expiration 與 apns-priority,並注意它會回傳明確的 PayloadTooLarge 錯誤,排查比舊協商簡單得多。

最後一個提醒:中文最多只能放約 85 個字(256 ÷ 3),若通知內容需要更長,務必走「推 id、拉內容」的路線。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved