必须启用TaoToken幂等性头字段并配置数据库唯一索引，删除查后再写逻辑，改用idempotent_insert动作，通过并发测试验证首次201、其余200且日志含idempotent_skip。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在 AionClaw 企业版中处理高并发写入时，若未配置防重机制，同一笔订单、工单或消息推送极可能被重复执行，导致数据库出现多条完全相同的记录、库存超扣、通知重复发送等生产事故。
必须启用 TaoToken 统一 Key 的幂等性头字段
启动 AionClaw 服务前，确保环境变量中已配置 TAOTOKEN_ENABLE_IDEMPOTENCY=true。该开关默认关闭，不手动开启则所有请求均视为非幂等。
客户端发起 POST/PUT 请求时，必须携带 HTTP Header：X-TaoToken-Idempotency-Key: {唯一字符串}。该 Key 应由前端按“用户ID+业务类型+时间戳+随机盐”拼接后 SHA256 生成，例如：sha256("u1001:order_create:1728752653:abc7x")。
若漏传此 Header，AionClaw 会直接拒绝请求并返回 400 错误，不会进入后续业务逻辑——这是第一道硬性拦截，【不可跳过】。
数据库层强制唯一约束（最后一道防线）
在部署 AionClaw 所连接的业务数据库中，为每个核心写入表添加复合唯一索引。
以订单表 orders 为例，执行 SQL：
ALTER TABLE orders ADD UNIQUE INDEX uk_user_order_time (user_id, order_type, created_at);
注意：不要只用 order_no 字段建唯一索引——AionClaw 的订单号生成器在极端并发下存在极小概率碰撞风险，必须叠加业务语义字段增强唯一性。该索引能兜底捕获所有漏网的重复写入，触发 DuplicateKeyException 后自动回滚事务。
禁用默认的“查后再写”流程模板
方法一：修改技能 YAML 配置文件
打开 /skills/invoice_submit.yaml 类写操作技能定义，在 steps 中定位到类似以下逻辑：
- action: "SELECT COUNT(*) FROM invoices WHERE invoice_no = {{input.invoice_no}}"
- if: "{{result > 0}}"
then: "skip"
else: "INSERT ..."
立即删除整段判断逻辑。AionClaw 2026.9.6 版本起已明确标注该模式为 【已废弃且不安全】，文档中仍保留仅为兼容旧迁移场景。
方法二：使用内置幂等动作替代
将原 INSERT 步骤替换为：
- action: "idempotent_insert"
table: "invoices"
key_fields: ["invoice_no", "tenant_id"]
data: "{{input}}"
该动作底层调用的是 Redis SETNX + 数据库 UPSERT 原子组合，无需额外编码。
验证防重是否生效
第一步：用 curl 并发发送 5 次相同幂等 Key 的请求
for i in {1..5}; do curl -X POST https://aionclaw.example.com/v1/skills/order_create \
-H "X-TaoToken-Idempotency-Key: a1b2c3d4e5f6" \
-d '{"user_id":"U999","amount":99.9}' & done
第二步：检查数据库 orders 表记录数
第三步：查看 AionClaw 日志中是否出现 idempotent_skip: key=a1b2c3d4e5f6 日志行
第四步：确认返回结果中仅有首次请求返回 201 Created，其余 4 次均为 200 OK 且 body 中含 "status":"idempotent_skipped"
