Agent 调接口超时后,怎样证明库存没有被重复修改?

简介: 本文通过SQLite实验揭示幂等性失效根源:库存更新与回执写入分属两次提交,导致进程崩溃后重试引发重复执行。提出将业务变更与幂等记录置于同一事务的修正方案,并验证其在多种异常场景下的正确性,强调幂等键需绑定确定业务意图,而非仅依赖请求参数。

假设一件商品当前库存是 4。用户让 Agent 记录一笔入库,数量为 3。接口请求带上固定的操作键 receipt-001,服务端也准备了一张去重表。

第一次调用后,库存变成了 7,但进程在返回结果前退出。客户端没有拿到响应,于是使用同一个操作键重试。

按预期,库存应该停在 7。实际却变成了 10。

这个错误不需要复杂的模型行为。只要“修改库存”和“保存幂等结果”分属两次提交,中间就存在一个窗口:业务已生效,去重记录还没留下。

我们用 Python 和 SQLite 做了一组独立实验,把这个窗口实际触发出来,再验证一种修正方式。下面的商品、门店和操作均为合成数据;这是业务接入设计实验,不是线上事故复盘,也不是百灵中枢新版本的功能发布。

一、先看一种很容易写出来的实现

代码通常会先查询操作键。如果没有记录,就修改业务,然后保存结果:

# 第一次事务:检查记录并更新库存
db.execute("BEGIN IMMEDIATE")
prior = find_receipt(db, tenant, op_key)
if prior:
    return prior
update_stock(db, tenant, sku, delta)
db.execute("COMMIT")

# 进程如果在这里退出,库存已增加,回执还不存在。

# 第二次事务:保存去重记录
db.execute("BEGIN IMMEDIATE")
save_receipt(db, tenant, op_key, fingerprint, result)
db.execute("COMMIT")

这段是流程简写,辅助函数省略了 SQL 与连接清理。问题在于两个 COMMIT。

第一次提交后崩溃,重启再查回执,得到的确实是“没有记录”。但这只能说明回执不存在,不能证明库存没有改过。随后再次更新,就产生了第二次业务效果。

把操作键放进 Redis 或内存,也不会自动补上这段原子性。关键要看去重状态和业务状态能否共同提交;仅给记录加上“唯一键”,无法回滚另一个已经提交的事务。

HTTP 语义也没有把“没收到响应”定义成“请求未执行”。RFC 9110 要求客户端不要自动重试非幂等请求,除非已知该请求实际具备幂等语义,或者能够确定原请求没有应用。RFC 9110 §9.2.2

二、操作键要绑定一项确定的业务意图

实验保留三张表:库存、库存变更记录、操作回执。库存和变更记录代表业务效果,回执保存这次操作的输入指纹与原始结果。

CREATE TABLE receipts (
    tenant       TEXT,
    op_key       TEXT,
    fingerprint  TEXT NOT NULL,
    result_json  TEXT NOT NULL,
    PRIMARY KEY (tenant, op_key)
);

tenant 来自可信身份上下文,不能让调用者任意填写门店身份。op_key 对应这一次入库意图,而不是每次网络尝试新生成的编号。

实验中的指纹由已验证主体、操作名、商品和数量计算:

payload = {
   
    "actor": actor,
    "operation": "inventory.add",
    "sku": sku,
    "delta": delta,
}
digest = hashlib.sha256(
    json.dumps(payload, sort_keys=True, separators=(",", ":")).encode()
).hexdigest()

这里限定数量为正整数,主体和商品为字符串;布尔值不作为整数接受。固定结构排序编码足够支撑本实验,但不是适用于所有语言、数值和对象的通用规范化协议。

同一个键再次到达时,要比较指纹。原来是增加 3 件,后来换成增加 5 件,应拒绝为键冲突,不能悄悄返回旧成功,也不能当作新操作继续做。

三、把业务变更和原始结果放进同一次提交

修正后的核心顺序如下。stock 表按门店与商品唯一定位,movements 保存每次实际入库变更;省略了函数外的建表及参数校验。

try:
    db.execute("BEGIN IMMEDIATE")
    prior = db.execute(
        "SELECT fingerprint,result_json FROM receipts "
        "WHERE tenant=? AND op_key=?",
        (tenant, op_key),
    ).fetchone()

    if prior:
        if prior[0] != digest:
            raise ValueError("idempotency_conflict")
        result = json.loads(prior[1])
    else:
        changed = db.execute(
            "UPDATE stock SET qty=qty+? WHERE tenant=? AND sku=?",
            (delta, tenant, sku),
        ).rowcount
        if changed != 1:
            raise ValueError("product_not_found")
        db.execute(
            "INSERT INTO movements(tenant,sku,op_key,delta) VALUES(?,?,?,?)",
            (tenant, sku, op_key, delta),
        )
        qty = db.execute(
            "SELECT qty FROM stock WHERE tenant=? AND sku=?",
            (tenant, sku),
        ).fetchone()[0]
        result = {
   "sku": sku, "added": delta, "stock_after": qty}
        db.execute(
            "INSERT INTO receipts VALUES(?,?,?,?)",
            (tenant, op_key, digest, json.dumps(result, sort_keys=True)),
        )

    db.execute("COMMIT")
    return result
except BaseException:
    if db.in_transaction:
        db.execute("ROLLBACK")
    raise
finally:
    db.close()

这段逻辑依赖一个明确前提:三张表在同一个 SQLite 数据库内,参加同一事务。原子提交让它们一起生效,或者一起不生效。SQLite 原子提交说明

BEGIN IMMEDIATE 在读取回执前取得写事务。SQLite 同一时刻只有一个写事务,因此两个进程不能同时越过“未找到回执”的检查并各自提交一次库存增加。第二个进程进入事务后会看到第一个的回执。锁竞争可能超时,不能把 SQLITE_BUSY 当作已成功;本实验设置 10 秒连接等待,不实现无限重试。SQLite 事务说明

换成 MySQL、PostgreSQL 或其他存储时,需要按其隔离级别、唯一约束与冲突处理重新实现,不能把这段 SQLite 行为直接当成所有数据库的保证。

四、验证时,看数据库效果,而不只看接口返回

本次在 Python 3.9.6、SQLite 3.54.0 下实际运行。每组建立独立临时数据库,使用 spawn 创建新进程,在指定位置调用 os._exit();这会直接退出进程,不执行 Python 的 finally。

测试读取三个独立结果:库存数量、入库变更记录数、幂等回执数。初始库存都是 4,单次入库都是 3。

场景 重启或再次调用后的实际结果
分开提交,库存提交后、回执写入前退出 库存 10,变更 2 条,回执 1 条,重复入库被复现
同一事务,写完三张表但提交前退出 恢复后库存4、变更0、回执0;原键重试后7、1、1
同一事务,提交后、返回结果前退出 原键重试返回已保存结果;库存7、变更1、回执1
两个进程同时提交同一键、同一输入 一个新执行,一个命中回执;库存7、变更1、回执1
同一键将数量从3改为5 拒绝冲突,库存仍7
同一键换成另一个主体 拒绝冲突,库存仍7
相同参数,但换成第二笔合法入库的键 允许新操作,库存变为10,变更2条
第二笔入库完成后,重放第一笔 返回第一笔的stock_after=7,当前库存仍10
另一已验证门店使用相同键 在另一门店独立入库,不修改前一门店

9 组预期行为全部与断言相符,其中第一组是刻意保留的错误对照。三个进程退出场景还检查了数据库完整性,结果均为 ok。

它们验证了这份脚本在指定提交位置的行为,不能外推成物理断电、磁盘故障、数据库故障转移或高并发压力测试。双进程同时调用是功能性竞争测试,没有测吞吐量。

五、相同参数,不一定是同一件事

用户今天收到 3 件商品,明天又收到 3 件,参数完全相同,却是两笔合法入库。如果直接用“门店+商品+数量”的哈希当永久去重键,第二笔就会被误删。

所以操作键与指纹承担不同职责:键识别这一次业务意图,指纹约束这次意图的内容。重试沿用原键,新的入库使用新的业务编号。一个任务包含多笔相同入库时,也要有能区分各笔操作的领域标识。

第八组还暴露了一个容易混淆的细节:回执里的 stock_after=7 是第一笔操作完成时的结果,不是库存查询接口的实时答案。其他合法操作发生后,当前库存可以是10。重放应保持原回执,查看现状则另做只读查询。

返回旧结果仍需经过身份与结果访问权限检查;幂等命中不能变成跳过权限的入口。本实验使用固定可信身份,不实现登录、权限撤销或完整HTTP服务。生产接入还要保留这些检查,以及回执保留期限、过期键处理规则。

六、本地事务能覆盖到哪里?

如果实际入库通过另一个系统的 HTTP API 完成,本地事务就不能把远端提交一起包住。先调用远端、再保存本地回执,仍可能出现远端成功、本地缺记录的窗口。

这时应由拥有库存事实的系统兑现业务幂等,提供原操作结果查询;上游保留稳定操作身份,遇到未知结果先核对。队列消息、外部通知以及真实货物搬运也不会随着本地 SQL 回滚自动撤销。

同样,先写一条“处理中”记录再改库存,也需要说明进程退出后如何判断和恢复。单独的占位只能表明有人开始处理,无法证明业务已经完成。本文把最终回执与本地库存共同提交,正是为了缩小这个无法判断的范围。

七、从一笔库存操作,回到 Agent 接入

Agent 接入后,用户一句“这笔再试一下”,可能经过客户端、运行时和业务接口。每一层都能看到一次调用,却不一定都知道库存是否已经提交。

A2B 讨论的受委托行动,在这里有一个具体落点:系统需要把用户想完成的一笔业务,与多次传输尝试区分开,并保留可核对的结果。

ACC 提供 execution.idempotent 等执行声明,让接入方表达操作语义;但声明不会替业务系统创建事务、回执表或恢复接口。当前公开库存示例将写操作标为非幂等,没有仅凭调用ID或版本字段承诺安全重试。ACC 规范 · 公开业务示例

百灵中枢 Core v0.10.1 的公开契约则说明:对非只读、非声明幂等工具,运行时使用持久化执行记录,提供关联任务、主体、工具和参数的稳定键;结果未知时阻止盲目重放。业务系统仍需按该键或更强的领域键去重,并执行最终授权。这是有边界的运行时治理,不是跨系统“恰好执行一次”的保证。Core 调用契约

因此,给现有接口接入 Agent 时,可以先做一个小验收:在业务提交前、提交后返回前各让进程退出一次,再同时发起两次相同请求。每次都核对业务数量、变更记录和操作回执。

幂等键提供识别依据;事务边界和业务侧记录决定这个依据能否兑现。 把这几处测清楚,才能知道“再试一次”到底会恢复原任务,还是制造第二笔业务。

相关文章
|
17天前
|
Linux 开发工具 iOS开发
Codex保姆级教程(下载+安装+登录+使用,含所有版本,2026最新)
Codex是OpenAI推出的开源AI编程智能体,本地运行,可理解整个代码库,支持自然语言指令改代码、执行命令、跑测试、修Bug,兼容Win/macOS/Linux。(239字)
7030 52
|
4天前
|
JSON 前端开发 API
阿里云最新Qwen4-Max大模型介绍:模型定位、特征、能力、适用场景解析
2026 年 11 月 11 日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问 AI 平台 Token Plan,并同步接入千问办公、Qoder 等入口。该版本聚焦知识理解、世界感知、编程与 Agentic 四项升级,主打复杂编程、专业办公、前端设计与专业软件操作。预览期至 11 月 25 日 24:00,到期后模型标识下线;限时 2 折、新用户再享 5 折,最低 1 折可体验。
|
5天前
|
云安全 人工智能 安全
|
17天前
|
JavaScript API iOS开发
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(DSH)是DeepSeek于2026年开源的MIT协议AI Agent框架,支持插件化组装模型、工具、沙箱与UI,兼容主流大模型。本文提供免Node.js的桌面端安装包(Win/macOS),含详细图文教程及热门插件推荐。
5473 65
|
12天前
|
Linux 开发工具 iOS开发
2026最新codex下载安装保姆级使用教程(下载+安装+登录+使用,含所有历史版本)
本文详解OpenAI Codex国内快速上手指南:提供Win/macOS/Linux全平台免安装包、npm/Homebrew等多方式安装、账号/API Key双登录、简体中文切换,覆盖下载、安装、汉化、使用及高频避坑(如微软商店失败、npm超时等),10分钟即可跑通。
2753 8
|
4天前
|
人工智能 前端开发 API
阿里云Qwen4-Max 大模型详解:定位、特征、能力、适用场景与相对Qwen3-Max差异解析
2026年11月11日,阿里发布第四代旗舰模型Qwen4-Max预览版,首发千问AI平台Token Plan并接入千问办公、Qoder等入口。该版本聚焦知识理解、世界感知、编程与Agentic四项升级,主打复杂编程、专业办公、前端设计与专业软件操作等真实任务。预览期为11月11日10:00至11月25日24:00,仅支持Token Plan调用,到期后模型标识下线;限时2折、新用户再享5折,最低1折可体验。
|
9天前
|
人工智能 安全 API
DeepSeek Harness下载、安装、配置一篇搞定(2026整理,送常用插件)
DeepSeek Harness(dsh)是DeepSeek AI于2026年开源的轻量级Agent运行框架,基于Cordis内核,践行“一切皆插件”理念。支持Web/桌面双端,开箱即用;内置多模型接入、丰富插件生态(超3.5万),适配编程、办公、创作等场景。(239字)
1789 1
|
2天前
|
弹性计算 人工智能 API
Codex超详细入门指南(下载·安装·登录·上手,全版本覆盖,2026最新版)
建议收藏本教程,2026 全年各版本更新随时回来查阅。如果你在搭建过程中遇到任何问题,欢迎结合 阿里云工单系统 提交技术支持请求,或在 阿里云开发者社区 搜索 Codex 相关话题交流。 祝你编码愉快,效率翻倍!
1180 0
|
8天前
|
人工智能 iOS开发 开发者
2026年 Codex 下载地址更新:codexdown.cn 已更换为 codexdown.cc(附 Codex 客户端下载)
2026年Codex官方下载站已由codexdown.cn正式迁移至codexdown.cc,提供Windows/macOS最新客户端、历史版本、安装教程及配置指南,开发者可一站式获取稳定、安全、签名验证的AI编程工具资源。(239字)
1625 0

热门文章

最新文章