---
title: 关闭批次排空与异常重试边界
type: review
project: DEMO-BatchPub
subsystem: software
status: historical
resolution: verified
verification: regression
delivery: local-only
created: 2026-10-26
updated: 2026-10-26
---

# 关闭批次排空与异常重试边界

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

2026-10-26 已写入并执行的虚构 Python 样例中，删除 `flush()` 对 `closed=True` 的提前返回后，关闭批次能够排空缓存；正常完成后再调用一次关闭 `flush()`，发布结果仍为 `[A, B]`。本次这两项验收通过，普通批次样本也继续通过。该结论限于所存源码与本地探针：发布中途异常后重试仍会重复发布 `A`，这一问题没有被本次修改解决。

## 修改为何能排空关闭批次

修改前的 [`batchpub_before.py`](../evidence/2026-10-26-batchpub/batchpub_before.py) 在 `closed=True` 时直接返回，后面的 `published.append(item)` 和 `pending.clear()` 都不执行。原探针中关闭批次因此留下 `pending=[A, B]`、`published=[]`。

已实施版本为 [`batchpub_after.py`](../evidence/2026-10-26-batchpub/batchpub_after.py)。以下是两份实际样例源码的差异，接口与普通批次路径保持原样：

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

删除提前返回使关闭批次也进入发布循环；循环正常完成后清空 `pending`，所以再次 `flush()` 时没有同一批元素可供重复追加。这同时说明“重复调用不重复发布”依赖前一次循环正常完成，不能外推到中途抛出异常的情况。

## 已执行的目标验收

执行来源、日期和交付范围见保存的 [SOURCE.md](../evidence/2026-10-26-batchpub/SOURCE.md)。协调者于 2026-10-26 在本地实际执行了 [`probe_batchpub.py`](../evidence/2026-10-26-batchpub/probe_batchpub.py)，标准输出原件为 [observations.json](../evidence/2026-10-26-batchpub/observations.json)。本次记录没有重新执行样例或修改输入。

探针每个正常用例均从 `pending=[A, B]`、`published=[]` 开始；重复用例连续调用两次 `flush(..., closed=True)`。实际结果如下：

| 用例 | 修改前的 pending / published | 修改后的 pending / published | 前后判定 |
| --- | --- | --- | --- |
| `normal_flush`，`closed=False` | `[]` / `[A, B]` | `[]` / `[A, B]` | 通过 → 通过 |
| `close_drain`，`closed=True` | `[A, B]` / `[]` | `[]` / `[A, B]` | 失败 → 通过 |
| `repeat_close_flush`，连续两次关闭 flush | `[A, B]` / `[]` | `[]` / `[A, B]` | 失败 → 通过 |

输出记录的 SHA-256 与本次读取的三份文件一致；完整哈希保留在 `observations.json`，可用于区分版本：

```text
batchpub_before.py  517567bc6059fe03fc7326759b33b4fd9d67b2d474ea2ffe639eea7998460c89
batchpub_after.py   31a38f06f439318cec9450ec58eb990a81abed2f0d84b3edae233019efbca3ac
probe_batchpub.py   b74424e01766f3537b9bc5ae9c6de8017f9d8449b60ff28ec73b7145eb58a66e
```

这些结果支持该虚构样例的目标验收及普通路径样本回归，不构成真实产品、板级或设备验收。并发、压力及真实系统测试均未执行；源码和探针仍为 `local-only`，没有提交、合入或发布记录，也没有可对应的产品仓库或镜像身份。

## 发布中途异常后的重复问题

`after_failure_probe` 使用 `FailOnceOnB.append()`：追加 `A` 成功，首次追加 `B` 时抛出 `simulated sink rejection on B`。原始输出保留了两个阶段：

```text
异常后：pending=[A, B]，published=[A]
重试后：pending=[]，published=[A, A, B]
duplicate_free=false
```

原因可由实际代码对应：异常打断发布循环，末尾的 `pending.clear()` 未执行，已经发布的 `A` 仍留在缓存；重试重新从 `A` 开始，造成重复。这是已观测到的异常恢复缺口，不能用正常完成后的重复调用通过来覆盖。

截至 2026-10-26，本次目标验收已完成，异常后重试去重仍未解决；本次没有实施其修复。若后续要求覆盖该条件，需要先明确部分发布后的缓存推进与重试语义，并以此异常用例验证方案。

## 影响与回退

改动只覆盖这份虚构样例 `flush()` 的关闭分支，未改变函数签名和普通批次的发布顺序。关闭批次现在会触发发布循环，因而也会遇到上面的下游追加异常；不能把“排空成功”描述成无条件保证。

本地回退对象是随库保存的 `batchpub_before.py`。仅在待还原的 after 文件仍匹配上述 after 哈希时，才可用 before 内容还原；回退会重新引入关闭批次不排空。该入口适用于这两个已保存样例版本，没有用于整体 revert 的源码提交。
