FCM向Android设备推送报「受限键"aps"」错误的问题咨询

核心故障触发逻辑 #

该报错完全不是你方服务端或移动端的代码、配置改动导致的，根源是FCM服务端静默上线的校验规则收紧：

• aps是苹果APNs推送服务专属的通知载荷顶级字段，从设计规则上本就不属于Android端FCM推送的合规载荷结构
• 此前推送服务稳定运行的一年里，FCM服务端对跨平台混写的载荷做了长期的弱兼容处理：只要请求的目标设备是Android，即便payload中不慎混入了aps字段，服务端会自动过滤掉不兼容字段后再正常下发，不会触发拒发
• 本次故障来自FCM服务端灰度上线的前置载荷校验规则：直接取消了对非APNs目标请求的兼容过滤逻辑，只要检测到请求JSON结构中存在aps顶级键，无论目标设备是Android还是iOS，直接判定为参数无效并拒发。这套新规则上线时没有任何官方前置公告，甚至没有同步更新公开文档，所有依赖旧兼容逻辑运行的推送服务，会在灰度覆盖到对应服务时突然失效，全程不需要用户侧做任何操作。

为什么官方受限密钥列表未收录aps键 #

FCM官方文档列出的受限密钥清单，仅覆盖FCM服务自身保留的、禁止在自定义data字段中使用的重名字段；aps属于跨推送生态的专属保留字段，在旧兼容逻辑下从未触发过校验报错，因此未被单独收录到通用受限字段列表中，也没有随着本次校验规则更新同步补充文档说明。

同类问题的开发者共性特征 #

目前该故障已被大量集成FCM的Android开发者反馈，共性场景和你遇到的情况完全一致：

• 服务端、移动端推送相关代码连续数月甚至1年以上无任何更新
• 突然收到rejectionReason="InvalidParameters: "aps" key is not permitted"的报错，无任何前置告警
• 排查后发现多数情况是为了统一跨端推送的结构，在通用payload模板中预留了空的aps占位字段，哪怕是空的{}没有实际内容，之前靠旧兼容逻辑一直正常下发，本次校验收紧后直接被拦截。

快速排查方向 #

• 定位所有向Android目标发送请求的payload构建逻辑，将非iOS请求中的aps字段完全剔除，哪怕是空值、空对象也会被当前的字符串匹配逻辑判定为违规
• 无需调整移动端任何代码，故障完全来源于服务端发出的请求结构触发了新的校验规则

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