直接用moltybob/dingtalk可避免签名拼错、token过期未刷新、content-type不匹配三大高频错误；它封装加签逻辑（hmac-sha256+timestamp+secret）、统一消息字段结构、要求显式初始化client并校验error，提升稳定性和开发效率。
直接用 moltybob/dingtalk，别手写 HTTP 请求——90% 的失败都来自签名拼错、token 过期没刷新、Content-Type 不匹配这三件事。
为什么不能裸写 http.NewRequest 发群消息
钉钉群机器人看似只是发个 POST，但实际有两套逻辑并存：普通 webhook（不加签）和加签 webhook。一旦你在钉钉后台勾选了「加签」，就必须同时传 timestamp 和 sign，且 sign 是 HMAC-SHA256(timestamp + "\n" + secret, secret)，不是简单 base64 或 md5。手写容易漏掉换行符、用错时间单位（必须是秒级整数，不是毫秒）、把 secret 当字符串传给 hmac.New 而不是 []byte(secret)。
- 常见错误现象：
{"errcode":310000,"errmsg":"invalid signature"} - 加签开启后，
access_token参数仍要保留，但签名校验优先级高于 token 有效性 - 不加签时，只要
access_token正确、JSON 格式合法、Content-Type: application/json设置对，就能通
moltybob/dingtalk 怎么初始化才不 panic
这个包不自动读环境变量，也不内置重试或超时控制，初始化时必须显式传入配置。最容易卡住的是 Client 构造失败却没检查 error，后续调用直接 panic。
- 必须检查
dingtalk.NewClient(...)返回的error，尤其当token为空或含空格时会立即返回 error - 建议设置
http.Client超时：&http.Client{Timeout: 10 * time.Second}，否则网络抖动时阻塞整个 goroutine - 如果要用加签，传入的
secret字符串不能为空，且不能含 BOM 或不可见字符（复制粘贴时容易带入）
发文本、Markdown、ActionCard 的参数差异在哪
钉钉对不同 msgtype 的字段要求严格，字段名大小写、嵌套层级、必填项全都不一样，SDK 封装层没做泛型校验，错一个字段就返回 400。
-
msgtype: "text"→ 必须有text.content字段，其他字段如at是可选的 -
msgtype: "markdown"→ 必须有markdown.title和markdown.text，title会显示在通知栏，text是正文（支持 markdown 语法） -
msgtype: "actionCard"→ 分整体跳转和独立按钮两种，字段结构完全不同，比如btnOrientation只在整体跳转模式下生效 - 所有消息体 JSON 必须 UTF-8 编码，中文别用 GBK；发送前建议用
json.MarshalIndent格式化调试
并发推送时 token 刷新冲突怎么避免
如果你用同一个 Client 实例在多个 goroutine 里发消息，而它内部没做 token 缓存锁，高并发下可能触发钉钉限流（errcode: 88001），甚至因并发刷新导致 token 覆盖失效。
-
moltybob/dingtalk本身不管理 token，只负责发请求；token 刷新逻辑得你自己写，并用sync.RWMutex保护缓存变量 - 别在每次
Send()前调RefreshToken()，应该在 token 过期前 5 分钟主动刷新，而不是等报错再刷 - 更稳妥的做法是：用
dingtalk-open-sdk-go（官方维护）替代，它内置TokenManager和刷新锁，但只适用于开放平台 API，不支持群机器人
加签计算、token 缓存、字段嵌套——这三个地方出错不会报具体哪一行，只会返回模糊的 400 或 invalid signature，调试时得逐项对照文档里的 JSON 示例和签名步骤，少一步都进不了群。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
