日志导出教学示例库

DEMO-LOGPIPE:关闭时尾批未输出

普通整理原稿

DEMO-LOGPIPE-2026-10-28.md下载原文件
示例库目录(4 篇文档)

日期: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 的限定通过不改写本轮失败。