---
title: PipeBatch v1/v2：发布、可见性与业务完成
type: project-note
project: DEMO-Pipe
status: maintained
created: 2026-10-28
updated: 2026-10-28
---

# PipeBatch v1/v2：发布、可见性与业务完成

[返回项目首页](./README.md) · [v1 排查记录](reviews/2026-10-28-pipebatch-publish.md)

## 版本与来源

2026-10-28 用户提供的虚构 PipeBatch 规范 v2 原文：

> push 仍写私有缓冲；publish 只提交发布请求并返回 token，返回时不保证读取队列已有数据；await_visible(token) 成功才确认数据进入读取队列。业务处理完成仍需独立确认。v1 的定义在原版本中仍然成立。

v1 的规范与给定日志保存在上述排查记录中。v2 是版本边界的补充，不撤销 v1 定义，也不能用于倒推 v1 日志中的接口语义。两份材料均不代表真实产品；本次没有真实实现、源码修改或新的实验结果，以下是规范说明，不是实现验证。

## 各阶段的保证

| 阶段 | v1 | v2 |
| --- | --- | --- |
| push(item) | 写入生产者私有缓冲 | 仍写入私有缓冲 |
| publish() | 将缓冲发布到读取队列；材料未规定返回与可见的关系 | 只提交发布请求并返回 token；返回不保证队列已有数据 |
| 确认可见 | 原材料未给出专门接口及其返回保证 | await_visible(token) 成功才确认数据进入读取队列 |
| 业务处理完成 | 原材料未给出确认机制 | 仍需独立确认；可见性成功不能代替业务完成确认 |

v2 中，发布请求已提交、数据已进入读取队列、业务处理已完成是不同的事件。拿到 token 只支持第一个判断；await_visible(token) 成功支持第二个判断，不能据此认定业务已经处理完成。材料没有规定等待失败或未成功时数据必然不可见，也没有给出可见性延迟上限或业务确认接口。

## 对批次结束发布方案的影响

[v1 记录](reviews/2026-10-28-pipebatch-publish.md)中的方案和证据继续限定在 v1。若将该思路用于 v2，批次结束调用 publish() 只完成发布请求提交；需要确认队列可见时，应使用返回的 token 调用 await_visible(token)，以成功结果作为确认依据。读取的超时安排必须允许数据在期限前变得可见，不能把 publish() 返回当作可读起点。若目标还包含业务处理完成，需另行取得业务完成确认。

这只是依据 v2 规范调整后的方案说明，尚未实施或验证。原 v1 日志中的 2 ms 时差不能作为 v2 发布请求耗时、可见性等待耗时或业务处理耗时的证据。

