生成请求幂等与并发边界
本文描述当前已落地的幂等保障;不等于跨供应商 exactly-once。
1. 单镜头视频
P6VideoGenerateRequest.request_key(可选,任意客户端生成的稳定 UUID/字符串)。shot_generation_snapshots.request_key持久化。- 唯一约束:
(shot_id, request_key)。 - 重复提交:
- 相同 key + 相同
input_hash→ 返回已有 task/snapshot,不再创建任务、不再预留额度。 - 相同 key + 不同
input_hash→ 冲突,要求新 key。
- 相同 key + 相同
- 并发:两个请求同时通过查询时,唯一约束只允许一个提交;失败方 rollback 后读取赢家。
- 前端:
- 预览成功生成新 key;
- 生成成功后再生成新 key;
- 网络重试保持旧 key;
- 用户主动重抽使用新 key。
2. 视频批次
VideoBatchCreate.request_key(同一剧集内唯一)。video_generation_batches.request_key+request_hash。- 唯一约束:
(chapter_id, request_key)。 request_hash覆盖:shot IDs(排序)、候选数、并发、场次、低覆盖确认。- 相同 key + 相同 hash → 返回已有 batch。
- 相同 key + 不同 hash → 冲突。
- 批次子任务仍通过
GenerationTask、item.enqueued_at和 coordinator 恢复,避免重复入队。
3. 供应商边界
- 幂等只覆盖“本系统创建任务”这一层。
- 如果请求已发送供应商但响应丢失,系统不能假设供应商支持 exactly-once。
- 真实调用应先查询供应商任务;无法确认时保留不确定状态,不自动二次提交。
- 额度按保守规则结算;人工恢复入口保留。
- 真实 L3/L4 尚未执行。
4. 迁移
048-add-generation-request-keys.sql:
- 幂等添加
shot_generation_snapshots.request_key与唯一索引; - 幂等添加
video_generation_batches.request_key/request_hash与唯一索引; - 旧行为无需回填;旧任务 request_key 为空。