日期:2026-10-28。范围:虚构 Python 教学夹具,不涉及公司源码、设备或真实网络服务。本轮未修改材料、提交或发布。
结论及边界
修改前 flush 在 closed=True 时提前 return,既不输出也不清空 pending;常规 closed=False 则逐条 append 后 clear。这解释了正常批次成功而关闭尾批滞留。材料证明队列没有被处理,不能据此断言真实磁盘或网络日志丢失。
修改后删除提前返回,closed 参数仍存在但不再影响执行。当关闭时确实调用 flush,且全部 append 和最后 clear 成功时,尾批按序输出并清空。普通批次行为保持。成功排空后、没有新增记录时再次调用关闭 flush 不重复输出。
已证实未解决:部分输出后异常再重试会重复。A 输出成功、B 首次拒绝时,clear 尚未执行,pending 仍为 [A,B],published 已为 [A];手动重试后得到 [A,A,B]。异常向调用者传播;代码没有自动重试。成功排空后的重复调用通过,不能推广为失败重试幂等或恰好一次交付。
本轮实际运行
环境:Windows PowerShell,Python 3.13.14。本轮实际重跑,退出码 0。根目录下的复现命令:
python -B --version
python -B materials/v1/probe_batchpub.py
-B 禁用 Python 字节码缓存。探针只读取夹具并将 JSON 打印到标准输出。退出码 0 不代表所有断言条件都通过,还须核对 passed 与 duplicate_free。
| 用例 | 修改前 | 修改后 |
|---|---|---|
| normal_flush | pending=[],published=[A,B],通过 | 同前,通过 |
| close_drain | pending=[A,B],published=[],失败 | pending=[],published=[A,B],通过 |
| repeat_close_flush | pending=[A,B],published=[],失败 | pending=[],published=[A,B],通过 |
修改后 partial_publish_then_retry:首次异常 simulated sink rejection on B,pending=[A,B],published=[A];重试后 pending=[],published=[A,A,B],duplicate_free=false。此失败探针仅运行修改后版本,不推定修改前的对应结果。
本轮结果 与 已有结果 已通过 Python 按 JSON 结构比较完全一致。材料目录检查未发现 pycache 或 .pyc。
证据和复核方法
- 修改前源码:关闭分支提前 return。
- 修改后源码:移除该分支,逐条 append 后整批 clear 的顺序不变。
- 探针:常规、关闭、重复关闭,以及 B 首次拒绝后的手动重试。
- 历史运行记录:既有证据;本轮结果另存,避免覆盖。
本轮探针记录的 SHA-256:
| 文件 | SHA-256 |
|---|---|
| batchpub_before.py | 517567bc6059fe03fc7326759b33b4fd9d67b2d474ea2ffe639eea7998460c89 |
| batchpub_after.py | 31a38f06f439318cec9450ec58eb990a81abed2f0d84b3edae233019efbca3ac |
| probe_batchpub.py | b74424e01766f3537b9bc5ae9c6de8017f9d8449b60ff28ec73b7145eb58a66e |
后续先核对指纹,再执行上述 -B 命令,核对每个用例的 pending、published、异常、passed 与 duplicate_free。指纹变化后需重新建立版本证据,不直接套用结论。
尚未验证和后续方向
未覆盖并发 flush/写入、真实关闭调用顺序、是否保证调用 flush、输出端关闭、进程崩溃恢复、磁盘/网络持久化、下游确认及 clear 失败。内存列表夹具不能证明真实系统的端到端交付保证。
针对已证实的重复问题,后续应先定义逐条确认和重试语义,再考虑确认后逐条出队,或输出端基于稳定记录标识去重。这些仅为待验证设计方向,本轮未实现。
可复用方法:比较正常与关闭路径的控制流,验证成功排空后的重复调用,再注入逐条输出中途失败并重试;分别记录队列、已输出前缀、异常和重试结果,区分尾批未处理与重复交付。
后续导航(不改变本轮历史范围)
以上结论保留为 v1 第一轮验证范围。“未解决”和“待验证”描述针对当时材料。独立 v2 接收端验证见 后续记录;条件化结论见 当前状态与复用说明;按版本复做见 操作说明。v2 的限定通过不改写本轮失败。