直接用http.post发请求大概率403，因加签、timestamp、json嵌套层级、换行符处理四者缺一不可；timestamp须毫秒级整数，sign需用secret对“ts secret”做hmac-sha256再base64编码，markdown消息必须严格嵌套为markdown.text且换行用 。
直接用 http.Post 发请求大概率会 403，不是 token 错，而是签名或消息结构不对。加签、timestamp、JSON 字段嵌套层级、换行符处理——这四点漏一个就发不出去。
为什么发请求返回 403 forbidden
钉钉自定义机器人开启「加签」后，webhookURL 必须带 timestamp 和 sign 参数，否则服务端直接拒绝。只传 access_token，哪怕完全正确，也一定 403。
-
timestamp是当前毫秒时间戳：time.Now().UnixMilli() -
sign是用机器人 secret（以SEC开头的完整字符串）对tsStr := strconv.FormatInt(ts, 10) + " " + secret做HMAC-SHA256，再base64.StdEncoding.EncodeToString - 最终 URL 形如：
https://oapi.dingtalk.com/robot/send?access_token=xxx×tamp=1712345678901&sign=xxx - 别手抖截短 secret——必须用创建机器人时页面显示的完整值
Markdown 消息结构必须严格嵌套
钉钉 API 对 markdown 类型消息的 JSON 结构有硬性要求：text 字段不能直接放在顶层，必须作为 markdown.text 的子字段存在。错一层，就静默失败或报 invalid msgtype。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 错误写法：
{"msgtype":"markdown","text":"# hello"} - 正确结构：
{"msgtype":"markdown","markdown":{"title":"标题","text":"# hello > 引用"}} -
text内部换行必须用\n或 HTML 换行符 - 若用
text/template渲染内容，记得先调用template.HTMLEscapeString防止特殊字符破坏 JSON
高频推送必须复用 client 并关闭 body
每次新建 http.Client 或不关 resp.Body，高并发下很快触发文件描述符耗尽、连接超时甚至进程卡死。
- 全局复用一个
&http.Client{Timeout: 10 * time.Second}，不要在函数里new(http.Client) - 每次
http.Do后必须defer resp.Body.Close()，哪怕你只读resp.StatusCode - 传 body 时优先用
bytes.NewReader(jsonBytes)，比strings.NewReader更符合二进制语义 - 如需代理或自定义 TLS，统一通过
http.Transport设置，而非反复 new client
生产环境必须加指数退避重试
Webhook 不是“发一次就行”，网络抖动、目标服务短暂不可用太常见。不重试 = 告警丢失；盲目重试 = 请求雪崩。
- 只对
5xx状态码、net.OpError、url.Error等连接类错误重试 - 跳过
400、410、422这类永久性错误，重试无意义 - 推荐策略：
1s → 2s → 4s → 8s，最多 4 次 - 绝对不要在 HTTP handler 里同步调用
http.Do——主流程必须零阻塞 - 异步推荐方案：内存 channel + worker goroutine，且 worker 必须监听
context.Context取消信号
最常被忽略的其实是 timestamp 和 sign 的拼接顺序，以及 markdown.text 的两层嵌套。这两个地方一错，连错误响应都收不到，只会默默失败。调试时建议先用 curl 手动构造一次请求验证签名是否正确，再移植到 Go 代码里。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
