2026年初，去中心化交易所（DEX）的月交易量突破2500亿美元。这个数字背后，是无数开发者正把交易逻辑从中心化平台迁移到链上聚合器API。但很多人没意识到：调用swap API和调用普通REST接口完全是两码事。返回的不是JSON数据，而是直接发往链上路由合约的原始交易调用数据（calldata）。错一个字段，交易回滚、gas费白烧、用户拿到离谱价格——三选一，或者全中。
Chainalysis统计，2025年DeFi领域因价格冲击（price impact）造成的损失超过9亿美元，大部分来自自动化系统没做校验就执行交易。
坑一：把-0.15当成-0.15%，用户直接亏掉15%
swap API返回的priceImpact字段是个小数。-0.0012代表-0.12%，正常滑点成本；-0.15代表-15%，意味着用户要把15%的本金喂给流动性枯竭的池子。
很多开发者扫一眼数字，觉得"负得不多"，直接放行。等用户发现到账金额少了八分之一，投诉已经晚了。
修复很简单：设阈值。普通场景拒绝priceImpact低于-5%的交易，大额交易收紧到-1%。代码就三行——获取响应、判断字段、抛出异常。但生产环境里，这三行经常缺席。
坑二：HTTP 200≠交易成功，"部分成交"状态被彻底忽略
swap API有个反直觉的设计：Successful、Partial、NoRoute三种状态都返回HTTP 200。Partial意味着只能成交你请求的一部分，amountIn和expectedAmountOut已经变成了实际可成交的数字，不是原始请求值。
如果代码里只判断了NoRoute，没处理Partial，用户以为换了1000 USDC，实际只到账300，剩下700卡在逻辑黑洞里。应用状态和用户预期从此分道扬镳。
拿到Partial响应后有三条路：按实际金额执行、把请求金额下调后重试、换交易对。唯独别干一件事——用原金额循环重试，流动性上限不会因为你执着就提高。
坑三：gasLimit照搬转账逻辑，多跳路由直接死在路上
Etherscan数据显示，2025年以太坊上约12%的失败交易死于gas耗尽。直接ETH换USDC可能15万gas，三跳路由穿过中间池子能飙到50万以上。
swap API故意不返回gasLimit字段——不同路由复杂度差异太大，给固定值反而害人。开发者得自己根据路由跳数估算，或者留足余量。抄ETH转账的21万gas上限去跑聚合器交易，等于给赛车加摩托车的油箱。
坑四：calldata原封不动塞给错误合约地址
API响应里有个to字段，指向链上路由合约。有些开发者硬编码了某个版本的合约地址，或者从缓存里拿旧地址，无视API实时返回的新地址。
路由合约会升级。calldata是为特定合约版本生成的，发给旧地址就是往黑洞里扔钱。交易回滚，gas照扣。
正确做法：每次都用响应里的to字段，别存本地，别信缓存。
坑五：忽略deadline字段，交易在内存池里躺到地老天荒
响应里有个deadline，Unix时间戳格式。超过这个时间，交易还在内存池里没被打包，就该作废重签。有些系统为了"省事"，直接设个极大值，或者干脆不检查。
结果用户提交时价格还行，十分钟后被打包，市场已经天翻地覆。MEV机器人早就把套利空间吃干抹净，用户拿到的是过期报价。
建议把deadline设成当前时间加30到60秒，提交前检查，超时就重新请求报价。
坑六：amountOutMin填0，"至少收到0"等于放弃所有保护
链上交易有个amountOutMin参数：用户愿意接受的最低到账金额。swap API返回的expectedAmountOut是预期值，实际可能因滑点波动。
有些开发者图省事，或者不懂业务，直接填0。这意味着"给我多少都行"，极端情况下1美元进去1美分出来，合约也认。
合理做法是用expectedAmountOut乘以(1 - 滑点容忍度)，比如允许1%滑点就乘0.99。这个值写进交易，前端显示给用户，双重确认。
坑七：错误处理只抓异常，没抓"成功但不对劲"
很多代码的try-catch只处理网络错误或合约回滚。但前面说的Partial状态、priceImpact超标、deadline过期，API都正常返回200，不会抛异常。
错误处理要分层：网络层抓超时和状态码，业务层校验每个字段的合理性。两层都过了，才走到签名广播。
一个常见的反模式：把API响应直接解构进交易参数，中间零校验。这就像把陌生人给的地址直接设成导航终点，不确认是不是火葬场。
这7个坑的共同点是什么？都不是技术难题，是注意力分配问题。每个都有现成的修复方案，但生产代码里反复出现，因为开发者把swap API当成了普通Web服务，没意识到自己在操作用户的真金白银。
2025年那9亿美元的教训，有多少本可以用三行校验代码避免？下一个被用户骂上推特的项目，会不会就是因为某个字段没检查？
热门跟贴