cdia/msgexchange-v2
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

docs(reference): 启动必需配置表首列改描述名，键走 PARAM 引用（修 97 引入的门禁红）

Browse Source 
check-docs 的 PARAM 定义判定按表格首列计数，重复键名导致三项参数报重复定义。
This commit is contained in:
windyboy
2026-09-21 16:16:28 +08:00
parent e5449a5cb1
commit 6980926a7c
1 changed files with 5 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/reference.md
+5 -5
View File
@@ -84,12 +84,12 @@
**值非法即拒绝启动**（无条件自检，不等 `autostart`）：
| 校验 | 条件 | 依据 |
| 校验项 | 条件 | 执行方 |
|---|---|---|
| `msgx.operation-day.zone` | 必须是可解析的 IANA 时区 | `PARAM:msgx.operation-day.zone` |
| `msgx.operation-day.cutoff-hour` | 取值 0–23 | `PARAM:msgx.operation-day.cutoff-hour` |
| `kafka.producers.default.acks` / `enable-idempotence` / `max-in-flight-requests-per-connection` | 联合满足幂等生产前提（`all`+`true`+`1`；旧 Broker 降级组合见 `D2`） | `D2` |
| `msgx.pipeline.backoff-ms` | 档位数必须等于 `max-attempts - 1` | 退避表（implementation.md「参数」） |
| 运营日时区（`PARAM:msgx.operation-day.zone`） | 必须是可解析的 IANA 时区 | 启动自检 `OperationDayZoneCheck` |
| 切日边界（`PARAM:msgx.operation-day.cutoff-hour`） | 取值 0–23 | 启动自检 `OperationDayZoneCheck` |
| Kafka 生产者幂等三项 | `D2` 三键联合满足幂等生产前提（`all`+`true`+`1`；旧 Broker 降级组合见 `D2`） | 启动自检 `KafkaD3Check` |
| 退避表（`PARAM:msgx.pipeline.backoff-ms`） | 档位数必须等于 max-attempts − 1 | 启动自检 `PipelineConfigCheck` |
**缺值**：带环境变量占位的必需键（`MSGX_PG_URL`、`MSGX_MAILBOX_URL`、`MSGX_KAFKA_SERVERS` 等）缺失时由 DI 解析失败拒绝启动，无需自检代码。