---
title: push 后读取超时与 publish 发布时序
type: review
project: DEMO-Pipe
subsystem: software
status: maintained
resolution: open
verification: unverified
delivery: local-only
created: 2026-10-28
updated: 2026-10-28
---

# push 后读取超时与 publish 发布时序

[返回 Review 索引](./README.md)

v1 给定规范与日志支持“push 后尚未发布，读取方无法读取私有缓冲中的 Q7”的解释。2026-10-28 补充的 v2 规范区分发布请求与队列可见：publish() 返回 token 后，需 await_visible(token) 成功才能确认数据已进入读取队列。下文按版本保留方案及检验条件，均尚待实施与验证。

## 来源与决定性证据

来源：用户于 2026-10-28 在本次会话提供的虚构试用材料，全部内容不代表真实产品。日志仅含时刻，采集日期未提供；以下完整保存本次判断所依赖的规范和样本。

PipeBatch 规范 v1：push(item) 只把数据加入生产者的私有缓冲；publish() 才把缓冲发布到读取队列。读取方只能读取队列里的数据。

```text
08:14:10.000 push(Q7,64B)
08:14:10.008 读取超时
08:14:10.050 publish()
08:14:10.052 读到 Q7，共64字节
```

2026-10-28 补充来源：用户在本次会话新提供的虚构资料《PipeBatch 规范 v2》。原文要点：push 仍写私有缓冲；publish 只提交发布请求并返回 token，返回时不保证读取队列已有数据；await_visible(token) 成功才确认数据进入读取队列。业务处理完成仍需独立确认。v1 的定义在原版本中仍然成立。本次未提供真实实现、源码修改或新的实验结果。

## v1 判断与方案边界

按 v1 规范，push 不会使 Q7 进入读取队列。样本中的读取超时发生于 publish 之前；publish 之后读到 Q7、共 64 字节，与规范描述的可见性边界一致。因此，不能把 push 完成当作读取方已可读取的条件。

v1 拟议方案是在批次结束时调用 publish()，把该批私有缓冲发布到读取队列。该方案要求批次能在读取方允许的等待时间内结束并执行发布；若读取超时早于批次结束，仅增加批末发布仍可能出现超时。

没有取得实现源码，也没有执行修改或实验；上述判断仅是规范与给定样本的核对，不能证明实现符合规范，或方案已经修复问题。样本中 publish 后读到数据也不是本次方案的验收结果。

## v2 的可见性与处理完成边界

v2 中 push 完成仍只说明数据写入私有缓冲。publish() 返回 token 只说明发布请求已提交，不能据此认定读取队列已有该批数据；await_visible(token) 成功才确认数据进入读取队列。队列可见也不代表业务处理完成，后者仍需独立确认。

适用于 v2 的拟议方案是在批次结束时调用 publish()，保存返回的 token，并以 await_visible(token) 成功作为队列可见的确认条件。读取等待时间需要覆盖批次结束及发布请求到可见确认的等待；仅在批末调用 publish() 无法保证返回时即可读取。等待未成功时，不能认定已经可见；失败、超时和重试的具体语义尚无资料，不能自行假定。若业务要求处理完成，还需另行确定并等待业务完成确认。

上述版本差异不推翻 v1 的定义及其原样本判断；原日志未包含 v2 token 或 await_visible 事件，不能用作 v2 行为或方案的验证证据。

## 下一步检验

取得实现后先确认规范版本，再核对 push、publish 和读取队列的实际行为及批次结束调用位置。以下为 v1 的待执行检验：在受控实验中记录批次结束、publish 与读取的时序，检查 Q7 是否在发布后以完整 64 字节读出，以及批末发布是否满足读取超时条件；若仍超时，应依据新日志重新判断发布时机与读取等待条件。

v2 还需记录 publish 请求及返回 token、对应 await_visible(token) 的结果和读取时序，核对可见确认后的数据完整性及读取等待条件；业务完成确认应单独记录。新步骤尚未执行，原 v1 样本不覆盖这些检验。
