怎么用 Go 语言实现企业微信消息接收与自动回复功能

使用 Go 语言实现企业微信消息接收与自动回复，核心是处理回调 URL 的验证请求与加密消息解密。适合自建后端服务场景，风险边界在于 EncodingAESKey 与 Token 的安全存储，泄露会导致消息被篡改或窃听。

先说结论：Go 标准库足以完成加解密与 HTTP 回调处理，无需依赖重型框架。

适合：需要自定义消息处理逻辑或对接内部系统的场景。
先看：企业微信后台配置的 Token 和 EncodingAESKey 必须与代码一致。
建议：优先使用 Go 标准库 crypto/aes 和 crypto/sha1 减少依赖风险。

快速处理思路

实现过程不涉及系统命令，核心是编写 HTTP Handler 处理逻辑。代码结构需包含验证接口与消息接收接口，重点在于 AES 解密与 XML 解析。

package main

import (
    "net/http"
    "crypto/aes"
    "crypto/sha1"
    "encoding/base64"
    "encoding/xml"
)

func main() {
    http.HandleFunc("/wechat", HandleCallback)
    http.ListenAndServe(":8080", nil)
}

func HandleCallback(w http.ResponseWriter, r *http.Request) {
    // 区分 GET 验证与 POST 消息接收
    if r.Method == "GET" {
        // 处理 echostr 验证
    } else {
        // 处理加密消息解密与回复
    }
}

为什么会这样

企业微信回调机制分为验证阶段和消息接收阶段。验证阶段通过 GET 请求 echostr 确认所有权，消息阶段通过 POST 请求发送加密 XML 数据。Go 语言的标准库 net/http 能直接处理请求，crypto 包支持所需的 AES-256-CBC 解密算法，无需额外中间件。

分步处理

第一步：在企业微信管理后台配置回调 URL。填写服务器 URL、Token 和 EncodingAESKey，确保与代码中常量一致。

第二步：实现 GET 请求验证逻辑。获取 query 参数 signature、timestamp、nonce、echostr，计算 SHA1 签名并与 signature 比对，一致则原样返回 echostr。

第三步：实现 POST 消息解密逻辑。读取请求体 XML，提取 Encrypt 字段，使用 EncodingAESKey 进行 AES 解密，去除 PKCS7 填充。

第四步：构建回复 XML。将回复内容加密，生成包含 Encrypt 和 MsgSignature 的 XML 结构返回给企业微信。

// 签名验证示例逻辑
func checkSignature(token, signature, timestamp, nonce string) bool {
    tmpList := []string{token, timestamp, nonce}
    sort.Strings(tmpList)
    tmpStr := strings.Join(tmpList, "")
    hasher := sha1.New()
    hasher.Write([]byte(tmpStr))
    return hex.EncodeToString(hasher.Sum(nil)) == signature
}

怎么验证是否生效

在企业微信管理后台“应用管理”查看回调配置状态，显示“正常”即验证通过。发送测试消息到应用，观察服务端日志是否打印解密后的明文内容，且用户端收到自动回复。

常见坑

AES 密钥长度必须为 32 字节，EncodingAESKey 是 Base64 编码，解码后需校验长度。XML 命名空间有时会导致解析失败，建议使用 struct tag 忽略未知字段。时间戳 timestamp 参与签名计算，服务器时间偏差过大会导致验证失败。

常见问题

签名验证一直失败怎么办

检查 Token 是否一致以及参数拼接顺序。signature 计算需将 Token、timestamp、nonce 字典序排序后拼接，再sha1 哈希。

解密后出现乱码或报错

确认 AES 模式为 CBC 且 IV 取密钥前 16 字节。Go 语言 crypto/aes 包需手动实现 PKCS7 去除填充，标准库不自动处理。

自动回复用户收不到

检查回复 XML 格式是否包含 encrypt 字段。加密消息模式下，回复体必须再次加密，不能直接返回明文 XML。

参考来源

企业微信开发者文档：回调模式 - https://developer.work.weixin.qq.com/document/path/90930

企业微信开发者文档：消息加密签名 - https://developer.work.weixin.qq.com/document/path/90965

Go 语言标准库 crypto/aes - https://pkg.go.dev/crypto/aes