---
title: queue 与 flush 的消费者可见性
type: review
project: DEMO-Dispatch
subsystem: software
status: maintained
resolution: open
verification: unverified
delivery: local-only
created: 2026-10-26
updated: 2026-10-26
---

# queue 与 flush 的消费者可见性

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

给定的 MiniDispatch v1 规范能够解释这组时序：`queue()` 只写生产者私有缓冲，消息要到 `flush()` 后才进入消费者可读队列。因此，11 ms 的读取发生在发布之前，200 ms 发布后、201 ms 读到 16 字节与该规则一致。在批次结束时调用 `flush()` 是拟议方案；目前未取得真实源码，也没有应用修改或执行实验，不能据此认定实现已修复。

## 规范与时序来源

来源是本次用户提供的虚构测试材料，记录日期为 2026-10-26；材料未提供真实系统身份或时序采集日期。决定判断的原文如下：

> MiniDispatch 协议 v1 规定 queue() 只把消息放入生产者私有缓冲，flush() 才将它发布到消费者可读队列。

给定时序为：

```text
10 ms   queue(16)
11 ms   consumer read 超时
200 ms  flush
201 ms  consumer read 得到 16 字节
```

规范摘记与这组时序是资料事实。它们支持“尚未发布能够解释读取超时”的判断，但这不是对某份真实实现的观测，也不能排除真实系统中其他超时原因。

## 拟议方案及待取得的证据

目标是让批次数据在批次结束时发布到消费者可读队列。拟在批次结束处调用 `flush()`，依据是协议把“写入私有缓冲”和“发布”分成了两个动作；只调用 `queue()` 不能满足发布目标。

尚未取得实际文件、调用点或差异，不能指定修改位置，也没有可执行的源码回退对象。需要先核对真实实现是否遵守这份 v1 规范、批次结束如何判定以及 `flush()` 的失败行为，再应用并验证方案。改变发布时机会影响该批次对消费者的可见时间；实际影响范围仍取决于这些未取得的实现条件。

本记录的验证状态为 `unverified`：只完成了给定资料之间的核对，没有实现静态检查、运行或设备验收。后续验收至少要取得应用方案的源码依据，并观测批次结束后的发布与读取结果。当前仅保存判断与方案，没有源码提交或发布证据。
