x402 收款接口的七项安全自检
作者提供开源自检工具,检查支付重放、结算后交付、路由绑定、缓存泄漏及用量上限等问题。在其 Base Sepolia 测试副本中,同价格、同收款地址的不同路由接受了同一支付,作者明确提醒该结果不能泛化。
AI 深度解读
给 API 接上 x402 支付后,收到付款和放行正确的接口,是两件需要分别验证的事。作者在自己的测试环境里发现:为一条路由支付的凭证,能被另一条同价、同收款地址的路由接受。
这不是对 x402 的普遍漏洞定论,却提出了一个具体问题:你的支付校验究竟绑定了哪些条件?对准备向 API 或 Agent 收费的开发者,这篇短文提供了七个检查方向,也明确交代了哪些风险没有测出来。
七项检查,分别在确认什么
x402 围绕 HTTP 402 为 API 和 Agent 提供支付机制。作者正在探索这个领域的开发机会,并提供了一份免费自查指南,可以在自己的 testnet 副本上运行,无需注册。
七项检查关注的是付款到交付之间的约束:
- 同一笔付款能否被重放,也就是把已经提交过的付款再次提交。
- 是否只有付款结算完成后,服务才交付内容。
- 付款是否绑定到它原本对应的路由。
- 缓存响应头能否阻止付费内容泄露给其他人。
- 支付相关请求头如何处理。
- 系统在多大程度上信任 facilitator,也就是支付流程中的协助方。
- 按使用量收费的 upto 路由,是否真正执行了金额上限。
这些问题不能互相替代。付款通过校验,不代表路由绑定正确;业务代码没有提前返回内容,也不代表缓存层不会把内容发给别人。
支付成功,只覆盖了收费接口需要满足的一部分条件。
同价、同地址的路由,可能共用一次付款
作者的实测发生在自己的 Base Sepolia 测试副本上,使用默认的 @x402/next 配置。
结果很具体:为一条路由支付的付款,被另一条价格相同、pay-to 地址相同的路由接受了。目标路由只要换了收款地址,或者换了价格,就会拒绝这笔付款。
如果两条接口必须分别付费,这个结果就值得检查。例如,接口路径虽然不同,支付校验却可能没有把路径当作区分它们的必要条件。
作者给出的处理办法是,为需要隔离的路由配置不同的 pay-to 地址或不同价格。在这次测试中,这两种差异都能把路由分开;同时共享价格和收款地址的路由,仍可能相互解锁。
但原文没有给出 @x402/next 的版本号,也没有展开校验代码。我们无法据此判断其他版本、配置和支付实现是否具有相同行为,更不能把它直接写成整个协议都存在的结论。
没测出来,距离排除风险还有多远
作者没有复现出付款重放导致重复交付,也没有观察到 upto 超额支出。缓存泄露同样没有出现,但他的测试副本根本没有缓存层,因此这次运行无法回答真实缓存环境中的问题。
还要分清两个现象:付款被另一条路由接受,与重放付款造成重复交付,并不是同一个测试结论。不能因为前者出现,就补写出后者也已发生。
作者还给出了一个规模参照:在 11 月 16 日 14:58 UTC 统计的 Coinbase Bazaar 目录中,33,455 条付费路由里,有 968 条标注了 upto。但目录里的标注不等于实际使用情况,这个数字不能说明相关交易量,更不能说明超额支出的发生率。
这份指南记录的是检查发现与验证边界,不是安全认证。
我的判断
我认同作者把「发现了什么」和「没有验证什么」分开写。尤其是主动说明没有缓存层,避免把一次没有观察到异常的运行,包装成风险已被排除。
路由隔离的发现也有实际价值,但适用前提是:这些路由在业务上确实应该分别收费。如果产品原本就允许一次付款访问一组接口,共享访问资格未必违反业务规则。
不同地址或不同价格,是作者这次实测支持的隔离办法。不过,收款地址可能牵涉对账,价格也受产品定价约束,不能只为了区分路由随意调整。另一种设计方向是让支付校验明确绑定目标资源,但原文没有证明默认配置是否支持,也没有提供两种做法的对照测试。
因此,这是一份有边界的小规模自查记录,适合拿来设计自己的测试,尚不足以替某个生产方案背书。
能拿来做什么
- 如果你用
@x402/next构建收费 API,可以在 testnet 准备两条同价、同 pay-to 地址的路由,验证一条路由的付款会不会被另一条接受,再分别改变价格和地址进行对照。 - 先写清接口之间的收费关系:哪些必须独立购买,哪些允许共享访问资格,再据此判断跨路由放行是否符合预期。
- 测试付费内容交付时,把实际部署中的缓存层纳入验证;没有缓存的本地副本,无法替 CDN 或反向代理回答泄露问题。
- 如果提供 upto 路由,应单独验证金额上限是否执行,并在测试记录中区分「没有观察到超额」和「已经验证上限有效」。