40 lines
2.5 KiB
Markdown
40 lines
2.5 KiB
Markdown
# P6 真实慢消费者背压回归
|
||
|
||
日期：2026-09-20。本批在一次性 MySQL 和真实 Orbit HTTP/WebSocket 服务上验证 SDK 消费器容量为 1 时的慢处理器背压。它补充 SDK 连接层重连边界，不代表跨节点重连、全局积压容量、磁盘/锁等待或生产 RPO/RTO 验收。
|
||
|
||
## 场景和结果
|
||
|
||
`TestIntegrationEventConsumerSlowHandlerBackpressure` 先投递一条取消结果，启动正式 `EventConsumer`，让第一个处理器停在业务处理阶段；处理器容量固定为 1。随后再产生第二条结果，测试通过真实订阅读取确认两条交付均已持久化，但在释放第一个处理器之前没有启动第二次处理，也没有提交 ACK。释放后两条交付都完成并各自只尝试一次。
|
||
|
||
| 证据 | 结果 |
|
||
| --- | ---: |
|
||
| 消费器本地容量 | 1 |
|
||
| 持久化交付 | 2 |
|
||
| 处理器调用（释放前） | 1 |
|
||
| ACK（释放前） | 0 |
|
||
| 处理器调用（最终） | 2 |
|
||
| ACK（最终） | 2 |
|
||
| 每条交付 attempts | 1、1 |
|
||
| 重复处理 | 0 |
|
||
|
||
同批定向真实服务回归还运行了 ACK 提交回执丢失和自然租约补发：三项合计 52.645 秒，均通过；慢消费者用例本身 3.15 秒。环境为 Docker Go 1.25.14 Linux arm64、一次性 MySQL 8.4.10，服务端和 SDK 使用临时 modfile，仓库声明的 Go 1.27.1 未修改。`go test -race` 通过，数据库外键为 0。
|
||
|
||
## 结论边界
|
||
|
||
该用例证明容量窗口会把慢处理器期间的后续结果留在服务端，释放后按原交付身份继续消费，不会在 SDK 内存中并行启动超出容量的处理器。业务处理器仍必须响应 context 取消，并在业务 Inbox 去重与业务效果同一事务提交后才返回成功。
|
||
|
||
当前仍未验证多个节点同时连接、跨节点慢消费者公平性、连接风暴叠加积压、租约到期期间的业务 Inbox 去重、数据库锁/连接池/磁盘曲线和生产容量。上述项目必须在目标拓扑中另行执行，不能由本次单节点样本推导。
|
||
|
||
## 复现
|
||
|
||
在一次性 MySQL、迁移完成、带 `worker-access` 与 `event-access` 的凭据以及真实 Orbit 服务后，执行：
|
||
|
||
```sh
|
||
cd sdk/go
|
||
ORBIT_TEST_WORKER_URL=http://127.0.0.1:$PORT \
|
||
ORBIT_TEST_WORKER_CREDENTIALS_FILE=/tmp/orbit-event-test/credentials.json \
|
||
go test -race -count=1 -run '^TestIntegrationEventConsumer(HeartbeatAndLostAck|FailureRedeliversNaturally|SlowHandlerBackpressure)$' -v .
|
||
```
|
||
|
||
缺少隔离服务或凭据时测试会跳过，跳过不能记作通过。标准 `make integration` 会在下一次完整回归中自动包含该用例。
|