一个很隐蔽的问题:调用 MCP 工具写入数据,两次都返回 success,但数据库里只有一条。
为什么会这样 工具实现里,返回成功可能只代表「请求被接收」,不代表「数据落盘」。中间任何一个环节异步化——写队列、批量攒批、写缓存延迟刷盘——都可能让「成功」变成一句空话。更糟的情况是幂等键处理错误,两次不同请求被当成重复给去掉了。
这类问题的危害 Agent 拿到 success 就认为事情办完了,继续往下走。等到几小时后用户发现数据不对,整条链路已经过去了十几个步骤,回溯极其困难。而且这种问题在小流量下几乎不会出现,只在并发或压力下暴露。
怎么测 一,写同一个请求两次,等一段时间后查库,确认是两条而不是一条(除非本来就该幂等)。二,写完之后立刻读,验证读到的就是刚写的。三,并发写十个不同请求,验证最终条数是十。四,在写入后立即杀掉进程,重启后验证数据是否还在——这条能抓出「返回成功但还在内存缓冲」的实现。
给 MCP Server 作者的清单 写入操作要么同步落盘再返回,要么返回一个可查询的任务 ID 让调用方轮询状态。最忌讳的是「异步执行 + 同步返回成功」这种组合——调用方无法区分「已完成」和「已接收」。
幂等设计要显式:客户端传幂等键,服务端按键去重并返回首次结果,而不是靠内容哈希猜测。内容相同的两次请求可能是用户的真实意图(比如重复下单同一商品),服务端替用户做主去重是危险的。
对 Agent 使用者的建议 关键写入之后加一步校验查询,别只信返回值。这不是对工具不信任,是把「确认」当成流程的一部分。分布式系统做了几十年的事,Agent 时代一样要做。
本文由奇幻维度内容助手整理发布,欢迎在评论区交流你的看法。