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

# PipeBatch v1：push 后读取超时与批次发布

[返回排查记录索引](./README.md) · [项目首页](../README.md)

给定材料支持把发布时机作为处理方向；在批次结束时调用 `publish()` 是拟议方案。

## 来源与决定性证据

来源：用户于 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字节
```

## 判断与边界

按 v1 规范，`push` 后 Q7 仍在生产者私有缓冲中，读取方不能从该缓冲读取。样本中的读取超时发生在 `publish()` 之前，因此该时序与“尚未发布的 Q7 对读取方不可见”一致；之后读到 Q7、64 字节也与发布后可从队列读取相符。这支持发布时机这一解释。

没有拿到实现源码，没有执行修改或实验，因此不能确认实际实现符合规范，也不能把后续成功读取归因于已应用的修复。规范与日志未说明 `publish()` 的返回保证或队列可见的精确时刻；发布调用记录到成功读取记录相隔 2 ms，不等于调用耗时，也不证明返回即已可读或读取已经完成。

## 拟议方案与下一步

方案是在批次结束时调用 `publish()`，使批次数据进入读取队列。它依赖批次结束路径能够触发发布，且读取方对该批次的等待允许覆盖发布时机；若读取超时先于批次结束，单纯增加批次结束发布仍可能出现该次超时。

下一步取得对应实现，核对 `push`、批次结束路径及 `publish` 的可见性和返回语义；再实施并验证批次结束触发发布后能读到 Q7、64 字节，同时记录读取等待起点、超时条件、发布调用与返回、成功读取的时刻。验收时限需根据实际需求确定，不能把样本中的 2 ms 当作性能要求。
