resource_not_exists错误根源是商户号未在微信商户平台api安全中启用平台证书或公钥，而非代码配置错误；需先在后台申请使用微信支付公钥，待证书下发后sdk才能初始化成功。
能跑通，但证书和回调解密是最大拦路虎，不是配置错，就是路径或格式没对上。
微信支付 V3 SDK 初始化失败：RESOURCE_NOT_EXISTS
这个错误不是你代码写错了，而是微信平台压根没给你发过平台证书——哪怕你已经下载了商户私钥 apiclient_key.pem，也必须先在商户平台「API安全」里点击「申请使用微信支付公钥」，等它自动生成并下发平台证书（通常几分钟内），SDK 才能正常初始化。
- 检查路径：
./resource/wxPay/apiclient_key.pem必须是绝对路径或确保运行时工作目录正确，否则utils.LoadPrivateKeyWithPath会静默失败 - 别硬编码证书序列号：
mchCertificateSerialNumber必须和商户平台「账户中心 > API安全 > 证书与密钥」里显示的「证书序列号」完全一致（含大小写、无空格） - SDK 初始化后首次调用接口（比如
client.Certificates().Get）才会触发证书自动下载，如果卡在这一步，大概率是商户号/序列号/APIv3密钥三者不匹配
Gin 路由接收微信回调时 400 或解密失败
微信回调请求头带 Wechatpay-Serial、Wechatpay-Timestamp、Wechatpay-Nonce 和 Wechatpay-Signature，缺一不可；而 Resource.Plaintext 解密失败，90% 是因为原始请求体被 Gin 自动解析过（比如用了 c.ShouldBindJSON），导致 body 已读空或换行符被破坏。
WeChat Article Parser - 微信公众号文章解析
下载
解析微信公众号文章，提取标题、作者、正文、图片等信息。用户发送链接（mp.weixin.qq.com）时触发，自动提取内容并可保存至飞书表格。
- 回调路由必须用
c.Request.Body原始读取：body, _ := io.ReadAll(c.Request.Body)，再传给downloader.MgrInstance().Decrypt - 时间戳校验默认宽松（5分钟），但如果服务器时间偏差大，会直接拒绝请求——用
ntpdate -s time.windows.com或chronyd同步系统时间 - 回调地址必须是 HTTPS，且域名必须和商户平台「产品中心 > 开发配置 > 支付授权目录」里填的一致，连末尾斜杠都不能多或少
生成 Native 支付二维码时提示签名失败
调用 /v3/pay/transactions/native 接口前，所有字段必须严格按微信文档顺序拼接、URL 编码、小写哈希，任意字段缺失、顺序错、空格多一个，签名就失效。
- 必填字段只有四个：
appid、mchid、description、out_trade_no，但notify_url必须和你在商户平台配置的完全一致（包括协议、端口、路径） - 金额单位是分：
amount.total传100表示 1 元，别传1.00 - SDK 默认用
core.NewClient构建的 client 会自动签名，但如果你手动构造 JSON body 再 POST，就得自己算签名——别这么干，直接用 SDK 封装好的client.TransactionNative().Do
最常被忽略的是：微信平台证书不是静态文件，它会定期轮换（一般 2 周一次），SDK 的 downloader.MgrInstance() 会后台自动刷新，但前提是你的服务不能重启太频繁，否则每次启动都得重新拉证书——留个日志打点，确认 certificates.Get 返回的 serial_no 和当前商户平台显示的一致。
