erlang_pay 先验章,再拆包:支付回调的验签到底在防什么

作者:leeyi日期:2026/9/25

erlang_pay 系列第二篇。这篇不限于 Erlang——不管你用什么语言接支付,回调验签的原理是同一套。 第一篇:erlang_pay:为 Erlang 补上支付这块拼图

想象一个场景。

你的服务器收到一条 HTTP 请求,内容大意是:

"你好,我是支付宝。订单 R123,用户已付款 1000 元,请发货。"

问题来了:你怎么知道这条消息真的来自支付宝?

发送方可能是支付宝的通知服务器,也可能是我——一台笔记本、一条 curl 命令就够了。如果你的服务器看到"支付成功"四个字就发货,那你的商品等于免费送:任何人只要知道你的回调地址和订单号格式,就能伪造回调。

防这个的机制就叫验签。用公文打个比方:支付宝发来的每条通知都盖了一个防伪章,你的服务器收件后,第一件事不是拆包裹,而是验章。章是假的,包裹直接扔掉。

erlang_pay 的铁律:先验章,再拆包

这个库把"先验签、后解析"写成了不可绕过的规矩:验签失败,报文一个字节都不解析。不是"解析的时候小心一点",而是根本不碰。

为什么顺序这么重要?因为解析报文本身就有风险——恶意构造的数据可能在解析阶段触发各种意想不到的路径。章都没验,凭什么拆人家的包裹?

三家机构的"防伪章"做法各不相同,erlang_pay 三种都实现了:

机构章你验章用的钥匙
支付宝RSA2 签名支付宝公钥
微信 v3平台私钥签名 + AES-256-GCM 加密的敏感字段微信平台公钥
StripeHMAC-SHA256webhook secret(开通 webhook 时给的那串)

前两种是非对称签名:支付宝/微信用它们自己保管的私钥盖章,你用公开的公钥验章。私钥不离手,所以别人盖不出同样的章——这就是"防伪"的原理。Stripe 更轻量:双方共享同一个 secret,各自对报文算一遍 HMAC,对得上就是真件。

三个容易漏掉的防伪细节

章的机制各家文档都写了,但下面三个细节,不做也不会立刻出事——出事的时候你甚至查不到被攻击了。erlang_pay 把它们做进了代码里。

细节一:防重放——门票当日有效

攻击者拿到一条真实的回调报文(比如从某处日志、网络截获),自己不动手伪造,直接原样重发 100 遍呢?签名是真的,验签全过——你的服务器就把同一个订单"发货"100 次。

防法很朴素:真通知里带时间戳,过期不认。微信的回调带 Wechatpay-Timestamp 头,erlang_pay 只接受与服务器时间相差 ±300 秒以内的通知(源码里 epay_wechat.erl 的 ?NOTIFY_TOLERANCE = 300)。五分钟前的真件尚且拒收,昨天捡来的票自然进不了场。

细节二:常量时间比较——对暗号不能露表情

验签的最后一步是比较两个字符串:算出来的签名和对方带来的签名。直觉写法是逐字符比,第一个字符不同就返回"假"。

问题出在"返回得快"上。逐字符比较遇到第一位不同立刻结束,遇到完全相同才比到最后——耗时不一样。攻击者可以掐着秒表一位一位试:"以 a 开头的签名响应是不是快一点点?"这就叫计时攻击:不用破解密码学,靠"表情"猜出答案。

erlang_pay 里验 HMAC 用的是自己实现的常量时间比较(epay_crypto:constant_time_equal/2),核心就一行循环:

1ct_equal(<<A, RA/binary>>, <<B, RB/binary>>, Acc) ->
2    ct_equal(RA, RB, Acc bor (A bxor B)).
3

不管哪一位不同,都把全部字符比完才给答案——比较过程"没有表情"。顺带说明:两个串不等长时直接返回 false、不用逐字节比——用源码注释的原话说,"长度本身非秘密"。

细节三:章是真的,还要核对"收件人"

假设验签通过——这确实是支付宝发的通知。还有一步:是发给你的吗?

一个支付宝开放平台可以挂多个应用,每家商户有自己的 app_id。一条发给别人的支付成功通知(别人的订单),签名同样是真的。所以 erlang_pay 验完签还要核对通知里的 app_id 和你 Cfg 里的是否一致,不一致返回 app_id_mismatch。

门卫验了工牌是真工牌,还得对一下名单:这位今天约的是不是你这间办公室。

最重要的一条:验签通过 ≠ 可以发货

这是本篇最想纠正的误区。很多教程的代码长这样:验签 → 拿到订单号 → 标记已支付 → 发货。中间缺了两步,钱就漏了。

erlang_pay 的 README 里写明了阶段语义,值得每个做支付的人都抄下来:

1verify_notify 通过
2  只证明一件事:AUTHENTICATED —— 这条通知确实来自支付机构,没被篡改
3
4它不证明:
5  ORDER_MATCHED —— 通知里的金额、订单,和你数据库里的对得上
6  IDEMPOTENT    —— 这条通知你没处理过(重发的通知会来很多次)
7  POSTABLE      —— 这笔账现在该不该入(订单状态可能不对)
8

验签只回答"章是真的"。名单要你自己对,账要你自己记。回调可能来多次(微信明确说通知可能重复),同一单可能有多条金额不同的通知,这些去重和匹配逻辑是你的业务责任,库替你做不了,也不该替你做。

附:一个"宁可功能少"的工程决策

0.2 版本里 erlang_pay 有个模块 epay_cert_mgr,负责微信平台证书的自动下载、轮换和序列号管理。0.3.0 把它删了。

原因写在 CHANGELOG 里:证书生命周期的"首次信任→轮换→serial 消费"没有做成闭环,留着它就有"看起来生产可用"的嫌疑。改成调用方自己注入平台公钥(platform_public_key),库只管验,不管证书从哪来。

做出"删功能"的决定比堆功能难。一个支付库里每个看起来自动化的环节,都对应一份"出了问题算谁的"的责任——没把握闭环的,宁可摆到明面上让你自己管。

验签失败长什么样

所有拒绝都有明确的错误码,方便你排查"为什么回调没生效":

错误码人话
bad_signature章是假的,或报文被改过
missing_signature没带章
serial_mismatch章是真的,但用的钥匙版本对不上(微信证书/公钥序列号不符)
timestamp_expired通知太旧,疑似重放
app_id_mismatch章真,但收件人不是你

每一条都对应上面讲的一个防伪环节。


仓库信息

本文涉及代码均可复核:src/epay_wechat.erl(?NOTIFY_TOLERANCE = 300)、src/epay_crypto.erl:136(constant_time_equal/2)、src/erlang_pay.erl(门面与错误合同)、README「安全要点 / 错误码」。

IMBoy(一个开源可私有化的 IM 平台,Erlang/OTP 后端)要收钱,就有了这个库。erlang_pay 从 IMBoy 项目里长出来,然后独立成仓回馈社区——它不绑定 IMBoy,任何需要接支付渠道的 Erlang/OTP 项目都可以直接拿去用。

系列第三篇:日元没有"分",退款要带流水号:支付代码里两条要命的规矩


参考文档


《erlang_pay 先验章,再拆包:支付回调的验签到底在防什么》 是转载文章,点击查看原文。


相关推荐


Go GOPROXY 兜底链的坑:从一次诡异的 CI lint 失败说起
江湖十年2026/9/17

首发地址:mp.weixin.qq.com/s/w49jd0zcp… 一天,我正在搬砖,本地修改完 Go 代码后,打算通过 make image 命令来构建 Docker 镜像进行测试。不过在构建镜像的过程中有一个报错,因为 make build 直接构建二进制已经通过,那肯定不是代码的问题,就没有在意。因为本机网络环境不是很好,大概率是网络问题导致 GOPROXY 代理站的模块拉取不到,直接让 Claude Code 帮我来解决。 Claude Code 非常给力,几秒钟就解决了问题,测试也很


Go 开发者也有自己的轻量工作流引擎了:go get 一行,5 分钟跑通一条审批流
mldong2026/9/9

一、搜"Go 工作流引擎",你会先搜到什么 场景很常见:公司一个 Go 服务(订单、工单、内部管理后台),产品说要加审批流。请假、报销、采购,单子从申请人出发,走到部门领导,复杂一点的要会签、按比例通过、退回发起人改材料、抄送一把手。 你去搜,会搜到 Temporal、Cadence、Asynq,再往外还有 Camunda。这些名字都很强,但花一个下午读下来你会发现,它们的主场是编排:长事务、任务重试、分布式补偿、跨服务的状态机。把它们请进一个 CRUD 系统里审批三张单子,等于为了走三张单子,


别再靠 Code Review 守底线:我做了一个静态分析项目 RedLine
潜龙勿用之化骨龙2026/9/1

Android 开发中,协程几乎已经成为异步编程的默认选择。但“使用协程”并不等于项目天然具备一致、可靠的异步模型。 很多项目在长期演进过程中都会出现类似情况:新的代码使用 suspend 和 Flow,旧模块仍然依赖 Callback、LiveData、RxJava 或 Java Future;有些人使用 Mutex 管理共享状态,有些人继续使用 synchronized 或 ReentrantLock;方法虽然标记为 suspend,内部却调用 Thread.sleep()。 之前写过And


Go 编程实战:闭包 Closure——函数如何记住外部变量
程序员爱钓鱼2026/8/24

上一篇我们学习了匿名函数 Anonymous Function,知道函数不仅可以拥有名字,也可以直接写成: func() { fmt.Println("Hello Go") } 匿名函数还可以保存到变量、作为参数传递,甚至作为另一个函数的返回值。在学习匿名函数时,我们留下了一个非常重要的问题: count := 0 add := func() { count++ } add() add() fmt.Println(count) 最终输出: 2 为什么匿名函数内部可以访问并修改外部的 c


二级市场流动性“击鼓传花”全景分析:游戏逻辑、资金分工、周期规律与生存法则
初晴融雪-快雪时晴2026/8/11

核心定调:A股二级市场绝大多数短期题材炒作、热点轮动、妖股行情,本质不是价值投资,而是依托流动性的击鼓传花零和游戏。股价涨跌与企业基本面脱钩,只取决于“当下有没有人愿意用更高价格接盘”。鼓声不停、 风险提示:本文为市场规律复盘分析,不构成任何个股买卖、投资操作建议,投机炒作风险极高,普通投资者需谨慎参与。 一、基础认知:什么是股市击鼓传花游戏?(核心定义) 传统价值投资逻辑:股价=企业未来现金流折现,靠企业盈利增长、分红、估值修复赚钱。 击鼓传花投机逻辑:股价=流动性情绪+资金接力


大模型技术 提示词模板 概述
元Y亨H2026/8/2

在 LangChain 中,提示词模板(Prompt Template) 是构建大模型应用的核心基石。 如果把大模型比作一个“极其聪明但没有记忆的员工”,那么提示词模板就是一份标准化的“工作指南”。它将用户的动态输入与预设的指令、上下文、格式要求结合起来,确保大模型能输出高质量、符合预期的结果。 一、 为什么需要提示词模板? 逻辑与数据分离:你不需要在代码里硬编码复杂的提示语。你可以定义一个模板,只在运行时注入变量(如用户的问题、背景资料)。 复用性:同一个任务(如翻译、总结)的指令可以定义


我用 AI 编程半年,这 5 个 Prompt 技巧让我效率翻倍
吴琼琼2026/7/25

我用 AI 编程半年,这 5 个 Prompt 技巧让我效率翻倍 不是 AI 不行,是你的提示词太随便了。 半年前,我第一次用 AI 辅助编程的时候,体验非常糟糕。 那时候我让 AI 帮我写一个「用户管理系统」,它给我生成了 800 行代码,里面掺杂了 PHP、Python 和莫名其妙的伪代码,接口命名毫无规律,错误处理完全没有。我当时心想:这玩意儿也就这样吧。 转折点发生在一个深夜。我加班改一个数据迁移脚本,困得不行,决定再给 AI 一次机会。但这次,我没有像平时那样随口说一句「帮我写个


官方文档像天书?这本开源的 WorkBuddy"蓝皮书",或许更适合小白入门
程序员晓凡2026/7/17

它不翻译官方说明书,而是用一个个真实任务,带你从第一项工作走到一支 AI 团队。 腾讯推出的全场景 AI 办公工具 WorkBuddy算是国内AI Agent 比较优秀的产品了。 简单来说,它是一个桌面 AI Agent 工作台:你只需要用自然语言描述需求,它就能自主读取本地文件、拆解任务、调用工具,最终交付一份可验收的成果——文档、表格、PPT、数据分析报告,甚至一条完整的视频。 官方文档地址:www.codebuddy.cn/docs/workbu… 你会发现一个问题:官方文档更像是写给


如何使用 Winget 下载 Claude Code 并实现绿色便携安装
越重天2026/7/8

🧑 博主简介:CSDN博客专家,「历代文学网」(PC端可以访问:https://lidaiwenxue.com/#/?__c=1000)总架构师,首席架构师,也是联合创始人!16年工作经验,精通Java编程,高并发设计,分布式系统架构设计,Springboot和微服务,熟悉Linux,ESXI虚拟化以及云原生Docker和K8s,热衷于探索科技的边界,并将理论知识转化为实际应用。保持对新技术的好奇心,乐于分享所学,希望通过我的实践经历和见解,启发他人的创新思维。在这里,我希望能与志同道合的朋友


线程概念与控制(中)
无忧.芙桃2026/6/30

本篇目标: 1.线程库的引入与理解 2.验证之前的概念 3.知道如何创建线程,终止线程,等待线程和分离线程 一.Linux线程控制 1.引入线程库 1.1.创建线程 通过之前对线程的理解,我们已经知道OS中有这么个执行流了,那么如何验证它是真的存在呢?那么就需要接下来的操作 首先我们需要创建一个线程,就需要用到pthread_create函数,如代码: 原型: int pthread_create(pthread_t *thread, const pthread_attr_

首页编辑器站点地图

本站内容在 CC BY-SA 4.0 协议下发布

Copyright © 2026 聚合阅读