---
title: BatchPub 关闭批次排空缓存与重复 flush 验证
type: review
project: DEMO-BatchPub
subsystem: software
status: historical
resolution: verified
verification: regression
delivery: local-only
created: 2026-10-26
updated: 2026-10-26
---

# BatchPub 关闭批次排空缓存与重复 flush 验证

[返回任务索引](./README.md) · [项目首页](../README.md)

删除关闭批次时的提前返回后，排空缓存和正常完成后重复 `flush()` 的目标在本地虚构 Python 样例中通过。异常后重试仍会重复发布 A，具体边界见下文。

## 来源与验收对象

2026-10-26 的[来源说明原文（SOURCE.md）](../evidence/2026-10-26/SOURCE.txt)确认：`batchpub_after.py` 是已写入并实际执行的修改版本；协调者已执行[探针](../evidence/2026-10-26/probe_batchpub.py)，[observations.json](../evidence/2026-10-26/observations.json) 是其标准输出。源码身份由输出中的 SHA-256 对应，随库保存的文件与这些哈希一致：

| 文件 | SHA-256 |
| --- | --- |
| [修改前 batchpub_before.py](../evidence/2026-10-26/batchpub_before.py) | `517567bc6059fe03fc7326759b33b4fd9d67b2d474ea2ffe639eea7998460c89` |
| [修改后 batchpub_after.py](../evidence/2026-10-26/batchpub_after.py) | `31a38f06f439318cec9450ec58eb990a81abed2f0d84b3edae233019efbca3ac` |
| [probe_batchpub.py](../evidence/2026-10-26/probe_batchpub.py) | `b74424e01766f3537b9bc5ae9c6de8017f9d8449b60ff28ec73b7145eb58a66e` |

此次验收对象是该样例的 `flush(pending, published, closed=False)`：关闭批次要排空已有缓存，成功完成后再次调用不得重发同一批。代码和探针均为 `local-only`，未提交、合入或发布。

## 修改与作用

以下是两份实际源码之间的差异：

```diff
 def flush(pending, published, closed=False):
-    if closed:
-        return
     for item in pending:
         published.append(item)
     pending.clear()
```

修改前，`closed=True` 会在发布循环之前返回，导致关闭时缓存仍在、目标列表为空。删除这一分支后，关闭路径也逐条执行 `published.append(item)`，全部成功后再 `pending.clear()`。非关闭路径保留原有逻辑；关闭后的 `flush()` 现在会向目标写入数据，调用者不能再依赖旧版的直接返回行为。

## 2026-10-26 实际结果

各用例以 `pending=["A","B"]`、`published=[]` 开始，判据均为结束时 `pending=[]` 且 `published=["A","B"]`。表中状态按 `pending / published` 表示；结果来自上述标准输出。

| 用例及条件 | 修改前 | 修改后 |
| --- | --- | --- |
| `normal_flush`：`closed=False` 调用一次 | `[] / ["A","B"]`，通过 | `[] / ["A","B"]`，通过 |
| `close_drain`：`closed=True` 调用一次 | `["A","B"] / []`，失败 | `[] / ["A","B"]`，通过 |
| `repeat_close_flush`：`closed=True` 连续调用两次 | `["A","B"] / []`，失败 | `[] / ["A","B"]`，通过 |

关闭批次的第一次调用成功后清空了缓存，第二次没有待发布项，因此没有重发 A、B。这是 `closed=True` 连续两次调用的实际覆盖范围。

## 异常重试：截至 2026-10-26 的遗留边界

`partial_publish_then_retry` 使用修改后版本和 `FailOnceOnB` 目标列表；目标第一次接收 B 时抛出 `RuntimeError("simulated sink rejection on B")`：

- 异常发生后，`pending=["A","B"]`，`published=["A"]`。
- 再次以 `closed=True` 调用后，`pending=[]`，`published=["A","A","B"]`，`duplicate_free=false`。

原因在于 A 已追加成功，B 的异常却使循环后的 `pending.clear()` 没有执行，重试仍从 A 开始。这说明正常完成后的不重复发布不能扩展为异常重试去重；该问题尚未解决。材料未覆盖并发、压力或真实系统测试，以上目标通过只适用于这次本地虚构样例。

## 本地回退条件

库内的 `batchpub_before.py` 是可用的本地回退内容。执行回退前，需确认待还原的 after 文件仍匹配本记录哈希，并保留后续修改；确认后才能用 before 内容还原 after。回退会重新引入关闭批次不排空的问题。没有可用于整体 revert 的源码提交。
