日志导出教学示例库

稳定记录 ID 与接收端内存去重验证

任务记录

Projects/DEMO-LOGPIPE/reviews/2026-10-28-idempotent-sink.md下载原文件
示例库目录(10 篇文档)

返回项目首页 · Review 索引

2026-10-28 独立后续任务:实际运行确认,同一接收端实例保留去重状态、重试复用相同 ID 与内容时,已接受但确认丢失后的整批重试不重复。verified 仅表示这一进程内教学目标通过;去重状态清空后重投递仍重复。没有修改材料或客户端,没有提交或发布。

对象与来源

Windows,Python 3.13.14,使用 python -B 禁止字节码缓存。目录不是 Git 工作树,版本用探针输出中的 SHA-256 定位。客户端仍为 v1 after,哈希 31a38f06f439318cec9450ec58eb990a81abed2f0d84b3edae233019efbca3ac;新实现为 IdempotentSink,哈希 a24df08c000ea0fc53da8f0996c2296982c5948a55fa95c644a1b4cf2fb061fc;v2 探针 哈希 853844dd0435db05557c74e44704d887d9f413cd5ea15cf5ed3133a911235c68。

实际观测与判断

输入为 L-101/A、L-102/B。客户端仍逐条 append,整批完成后才 clear;变化在接收端,不是客户端新增进度或事务。

探针阶段 观测 能支持的结论
first_attempt 两条都在 stored;pending 仍保留两条;异常 record stored, acknowledgement lost L-102 已被接受后抛异常,异常不等于未接受;clear 未执行
same_receiver_retry pending=[];stored 仍为两条;duplicate_free=true 相同实例与内存 seen、相同 ID 和内容使整批重试被去重
id_conflict 同一 L-101 改 payload 后报 same record id with different payload ID 冲突被拒绝,不是覆盖或当作成功重放
after_dedup_reset 清空 seen 后重投两条,stored 为 A,B,A,B;duplicate_free=false 无去重状态时,不再具备该无重复保证

IdempotentSink.append 先检查 seen:ID 已存在且内容一致时直接返回,内容不同则抛 ValueError。新 ID 先记 seen 再保存记录,L-102 首次保存后故意丢确认。重试复用了记录 ID,故两个 append 均可正常返回,客户端最终清空 pending。稳定 ID 是输入约定,本探针没有实现或验证生产系统的 ID 生成方案。

forget_dedup_state 只清空 seen,保留列表和 lost_ack 标记;这是状态丢失后重放的定向反例,没有实际重启进程或重建网络服务。重启会失去内存状态是实现边界,不能把本实验写成已验证真实重启恢复。

旧失败仍成立的条件

v1 FailOnceOnB 在接受 A 后、接受 B 前拒绝,pending 未清空,整批重试得到 [A,A,B]。本轮再次实测 duplicate_free=false。v2 则覆盖 B 已接受而确认丢失这一不同故障点;它证明接收端有条件去重,不能证明旧客户端自身具有任意重试幂等性。v1 before 的关闭提前返回也仍由旧探针复现。

因此第一轮“部分成功后的无重复重试不成立”继续适用于当时无去重的接收端;复用于新组合时必须加上接收端契约与状态条件。若重试改变 ID,将绕过按 ID 去重,这是代码支持的推断,本轮没有单独实验。

截至 2026-10-28 的验证边界

单线程同步进程内模拟,无真实网络、磁盘持久化或产品验收。未验证并发、持久化去重、跨实例共享、真实崩溃恢复、容量淘汰或异步确认。当前开放边界由 STATUS维护;复做命令及判读见版本化验证操作说明。