加了 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 端自行計算。
削減欄位只是應急,真正該做的是改變設計思路:
apns-expiration 與 apns-priority,並注意它會回傳明確的 PayloadTooLarge 錯誤,排查比舊協商簡單得多。最後一個提醒:中文最多只能放約 85 個字(256 ÷ 3),若通知內容需要更長,務必走「推 id、拉內容」的路線。