Firebase 初始化失败主因是生产环境未挂载 serviceAccount.json，应将密钥 base64 编码存入环境变量 FIREBASE_AUTH_KEY，运行时解码后传给 option.WithCredentialsJSON；Send() 仅表示入队非送达，需按 error 类型处理；iOS 必须显式设置 apns.Production；主题推送须用 SendToTopic() 且主题名仅支持小写字母、数字、下划线和连字符。
firebase.NewApp 初始化失败：别直接读 serviceAccount.json
生产环境挂载明文密钥文件几乎不可能，option.WithCredentialsFile("serviceAccount.json") 在本地跑得通，上线就报 open serviceAccount.json: no such file or directory。根本原因不是路径错，而是部署时根本没这文件。
- 把服务账号 JSON 文件用
base64 -w 0 serviceAccount.json编码，结果存进环境变量FIREBASE_AUTH_KEY - 运行时用
base64.StdEncoding.DecodeString()解码，注意尾部=缺失或多了会导致illegal base64 data - 解码后传给
option.WithCredentialsJSON(decodedKey)，而不是文件路径 - 环境变量未加载常见于 Docker 启动未加
-e FIREBASE_AUTH_KEY=...或 systemd 服务未在[Service]段声明Environment=
fcmClient.Send() 返回 success 不代表设备收到
Send() 只是把消息提交到 FCM 后端队列，返回的 message ID 仅表示“已入队”，不是“已送达”。iOS 静默失败、token 过期、APNs 配置错，都会让消息消失得毫无痕迹。
- 必须检查 error 类型：
messaging.Unregistered（token 已注销）、messaging.InvalidArgument（参数格式错）、messaging.Unavailable（FCM 临时不可用） - iOS 设备必须显式设置
apns.Production: true或false，默认值会错配沙箱/生产环境，导致无声失败 - 不要在 HTTP handler 中同步调用
Send()并等待响应；高并发下容易阻塞，应改用 goroutine + 重试（最多 2 次）+ 记录死信 - 批量推送优先用
SendAll()而非多次Send()，它能复用连接并返回每个 token 的具体错误
向主题推送必须用 SendToTopic()，不能混用
主题推送和单设备推送走的是完全不同的 FCM 接口，参数结构不兼容。Send() 或 SendAll() 传 Topic 字段会直接报错 InvalidArgument: mismatched topic name。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 发主题消息只能用
fcmClient.SendToTopic()，且主题名只支持小写字母、数字、下划线和连字符，长度 ≤ 100 - 主题订阅是客户端行为（Android/iOS SDK 调用），服务端无法主动绑定或解绑
- 主题名含大写、空格、中文或特殊符号（如
@、.）会导致InvalidArgument - 测试阶段可用
beeep.Notify()快速验证通知逻辑是否触发，绕过 FCM 网络链路
context 超时缺失会导致服务启动卡死
firebase.NewApp() 和 fcmClient.Send() 都依赖 context.Context 控制超时。若传 context.Background() 或未设 deadline，网络抖动时可能无限等待，拖垮整个服务初始化或请求处理。
立即学习“go语言免费学习笔记（深入）”；
-
firebase.NewApp()建议用带 10 秒超时的 context，避免因密钥解码或元数据拉取失败而卡住 -
fcmClient.Send()必须传带超时的 context（如context.WithTimeout(ctx, 5*time.Second)），否则 FCM 后端无响应时 goroutine 会永久挂起 - HTTP handler 中若复用同一个 context（比如从 request.Context() 直接传入），需注意其生命周期是否覆盖完整推送流程
实际集成中最容易被忽略的是：APNs production 字段的显式设置 和 主题名的字符限制。这两个点不出错时一切正常，一出错就是静默丢弃，日志里连 warning 都没有。
