silenceper/wechat/v2 不能直接用于企业微信，因其专为公众号设计，硬编码了公众号域名、token获取路径及sha1验签规则；而企业微信使用qyapi.weixin.qq.com、jwt式token、corpid/corpsecret鉴权及不同xml结构。
企业微信和微信公众号是两套独立系统，API 域名、鉴权方式、消息结构、推送逻辑全都不兼容——用同一套 Go 代码同时对接两者，不改结构体、不换 client、不重写验签，100% 失败。
为什么 silenceper/wechat/v2 不能直接用于企业微信
这个库专为微信公众号（含服务号/订阅号）设计，底层硬编码了 https://api.weixin.qq.com 域名、access_token 获取路径和签名规则。企业微信的 API 地址是 https://qyapi.weixin.qq.com，gettoken 接口参数是 corpid 和 corpsecret，且所有消息接口必须带 access_token 查询参数，不是 Header。直接复用会导致：
-
404：请求发到公众号域名，企业微信服务器根本收不到 -
40029：signature 验证失败——企业微信不用 timestamp/nonce/token 拼接 SHA1，它只认自己的 JWT 签名或固定 token -
40014：access_token 格式错误——公众号的 token 是字符串，企业微信的 token 是带过期时间的 JSON Web Token，且需按GET /cgi-bin/gettoken?corpid=xxx&corpsecret=xxx方式获取
encoding/xml 解析企业微信回调时字段全为零值
企业微信推送事件（如进群、退群、群消息）是 XML，但和公众号格式不同：根节点是 <xml></xml>，但关键字段如 <chatid></chatid>、<fromusername></fromusername> 全部首字母大写，且无命名空间。Go 的 encoding/xml 默认忽略大小写差异，但必须显式绑定：
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 结构体字段名必须首字母大写（Go 规则），但
xmltag 必须严格小写匹配原始标签名，例如ChatID string `xml:"ChatId"`，不是"chatid"或"ChatID" -
CreateTime是整数类型，不是字符串；若定义为string，xml.Unmarshal会静默失败，字段保持空 - 企业微信 XML 中可能含
，字段类型必须为string，且 tag 后加,cdata，例如Content string `xml:"Content,cdata"`
企业微信 send_msg 接口返回 40013 或 40001
这两个错误码高频出现，原因非常具体：
-
40013：invalid appid —— 不是公众号的 AppID，而是企业微信「应用」的agentid填错了。注意：agentid是数字，不是字符串，传参时别加引号；且必须和调用gettoken时用的corpid+corpsecret属于同一个企业应用 -
40001：invalid credential ——access_token过期或无效。企业微信 token 有效期 2 小时，且不同corpid的 token 不能混用。不要全局缓存一个 token 变量，必须按corpid+agentid维度隔离缓存，并在 HTTP 请求失败且响应含"errcode":40001时主动刷新 - 发送文本消息时，
msgtype必须小写"text"，不是"TEXT"或"Text"；JSON body 中的chatid字段名是小写，不是ChatID
并发推送外部群时消息乱序或重复
企业微信对外部群（含客户群）的 send_msg 接口有明确频控：每个应用每分钟最多调用 600 次，单个群每秒最多接收 20 条。用 Goroutine 盲目并发，极易触发限流，导致部分请求被丢弃或延迟下发。更隐蔽的问题是：
- 多个协程共用同一个
access_token缓存实例，token 刷新时发生竞态，旧 token 被覆盖后新请求仍携带已失效 token - 未对
chat_id做哈希分桶，所有群消息打到同一个 HTTP client 连接池，TCP 连接复用引发底层缓冲区错位 - 企业微信不保证投递顺序，但业务要求“先发的通知必须先到”，此时必须在应用层加序列号 + 本地队列保序，不能依赖接口本身
最易被忽略的一点：企业微信的「外部群」和「内部群」使用完全不同的接口路径与权限体系，chat_id 前缀不同（外部群以 wrp_ 开头），但错误地把内部群 ID 传给外部群接口，会静默失败而非报错。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
