golang如何集成极光推送_golang极光推送集成教程-Golang-PHP中文网

go 集成极光推送应选用 github.com/ylywyn/jpush-api-go-client，关键在于填对 appkey/mastersecret、写准 platform、合规构造 audience；禁用裸 device_token，须用 alias/tag/registration_id；响应需解析 body 而非仅看 status code。

golang如何集成极光推送_golang极光推送集成教程

Go 语言集成极光推送（JPush）没有官方 SDK，但社区有稳定可用的第三方 client，关键不是“能不能调通”，而是「鉴权字段填对、平台标识写准、 audience 构造合规」——这三点错一个，400 或 401 就直接返回，连日志都看不出哪错了。

用哪个 Go client？别自己拼 JSON

社区最常用的是 github.com/ylywyn/jpush-api-go-client（非官方但维护活跃，适配 v3 API）。自己手写 HTTP 请求 + json.Marshal 容易漏字段、错嵌套、时区偏移，尤其 platform 和 audience 的结构必须严格按极光文档嵌套。这个 client 封装了 payload 构建逻辑，比如：

pf := jpushclient.Platform{}
pf.Add(jpushclient.ANDROID)
pf.Add(jpushclient.IOS)

ad := jpushclient.Audience{}
ad.SetAlias([]string{"user_123"}) // 别名推送
// 或 ad.SetTag([]string{"vip"}) // 标签推送
// 或 ad.All() // 全量

别用已归档或 star 很少的库，比如某些 fork 自老版本的 client，不支持 setNotification 或厂商通道字段
注意 import 路径是否带 v2 或 v3 后缀，极光 v3 API 的 /v3/push 接口和旧版字段不兼容
该 client 默认走 HTTPS，无需额外配置 TLS；但若公司内网强制代理，需手动给 http.Client 设置 Transport

AppKey 和 MasterSecret 填错是最高频错误

极光控制台里有两个关键字符串：AppKey（应用标识）和 Master Secret（主密钥），不是「App Secret」或「API Secret」。填错表现通常是 {"error":{"code":1010,"message":"Invalid appkey or secret"}}。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

AppKey 是一串 24 位字母数字组合（如 a1b2c3d4e5f6g7h8i9j0k1l2），在控制台「应用设置 → 应用信息」页最上面
Master Secret 是另一串 32 位字符串，在同一页面「应用密钥」区域，标题明确写着「Master Secret」
这两个值不能从环境变量里读错行，建议用结构体显式加载：type JPushConfig struct { AppKey, MasterSecret string }，避免字段名拼写错误

单设备推送必须用 alias/tag/cid，不能裸填 device_token

极光不接受 iOS 的 device_token 或 Android 的 fcm_token 直接当目标传。所有推送必须通过 audience 指定逻辑标识：alias（用户级）、tag（分组级）、cid（个推 CID，仅限个推通道）或 registration_id（极光自生成的注册 ID）。

服务端生成 alias 建议用业务主键，比如 "uid_10086"，前端 SDK 初始化后调 JPushInterface.setAlias() 绑定
如果没做 alias 绑定，临时测试可用 registration_id：它在客户端首次注册成功后由极光返回，格式类似 160a1a94e6f（13 位左右），可通过极光后台「用户查询」功能查到
别把 audience 写成空对象或 null，否则会静默失败或推给全量用户

推送失败时先看响应 body，别只盯 status code

极光 API 即使返回 200，body 里也可能含 "error" 字段；而 400 时 body 才真正说明问题。常见陷阱：

"code":1009 表示 audience 不合法——检查 alias 是否为空字符串、tag 名是否含非法字符（如空格、中文、下划线开头）
"code":2001 是 message/notice 字段缺失：v3 API 要求至少设 message 或 notification，不能两者都空
Android 通知不显示？确认 android 子结构里设置了 builder_id（对应通知渠道 ID），且客户端已创建同名渠道
日志里出现 "invalid timestamp"？不是时间戳本身错，而是你用的 time.Now().UnixMilli() ——极光只要秒级，必须用 time.Now().Unix()