Android订阅无填充Base64格式FCM主题时出现无效主题名异常

问题背景 #

我在Android应用里尝试订阅一个无填充（去掉了=）的Base64格式FCM主题时，直接抛出了非法参数异常：

java.lang.RuntimeException: Failure delivering result ResultInfo{who=null, request=321, result=0, data=null} to activity {com.example/com.example.view.activity.MainActivity}: java.lang.IllegalArgumentException: Invalid topic name: aHR0cDovL3d3dy5iYmMuY28udWsvbmV3cy8 does not match the allowed format [a-zA-Z0-9-_.~%]{1,900}

我原本以为这个Base64字符串符合规则，但实际却触发了错误。另外还有几个迷惑的点：

• FCM控制台显示没有任何主题，但往这个主题发消息时提示发送完成
• 用Admin SDK发消息返回了响应projects/project-id/messages/5312412342391596688，但控制台还是看不到主题记录
• 应用订阅类似afsfsfsggg这种纯字母的主题完全正常

问题根源 #

核心问题出在Base64编码的字符串包含了FCM主题不允许的/字符。

仔细看错误提示里的正则规则[a-zA-Z0-9-_.~%]{1,900}，允许的字符只有字母、数字，以及-、_、.、~、%这几个符号。而标准Base64会用/和+作为编码字符，这俩都不在FCM的允许列表里——哪怕你去掉了末尾的填充=，只要有/或者+，就会触发非法参数异常。

至于控制台没主题但发消息成功的情况，是因为FCM主题是延迟创建的：只有当至少一个设备成功订阅后，主题才会在控制台显示。发送消息的操作本身不会校验主题是否存在，只要消息格式合法就会返回成功，但实际上没有设备接收，所以控制台也不会留下主题记录。

解决方案 #

解决办法很简单：把Base64字符串转换成URL安全的Base64格式，替换掉FCM不允许的字符：

1. 将/替换为_
2. 将+替换为-
3. 保留你已经做的去掉末尾=的操作

举个Java代码示例：

String originalBase64Topic = "aHR0cDovL3d3dy5iYmMuY28udWsvbmV3cy8";
// 转换为FCM兼容的主题名
String fcmSafeTopic = originalBase64Topic.replace("/", "_").replace("+", "-");
// 执行订阅
FirebaseMessaging.getInstance().subscribeToTopic(fcmSafeTopic);

之后用Admin SDK发消息时，也要用这个转换后的主题名，才能匹配到订阅的设备。如果之后需要还原回原始Base64，只需要反向替换（_换回/，-换回+）就行。

额外提醒 #

FCM主题名的长度限制是1-900字符，转换后的URL安全Base64长度不会超过原字符串，所以不用担心长度超限的问题。

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