From 6980926a7cacb0404f128b1ff33990715b803844 Mon Sep 17 00:00:00 2001 From: windyboy Date: Mon, 21 Sep 2026 16:16:28 +0800 Subject: [PATCH] =?UTF-8?q?docs(reference):=20=E5=90=AF=E5=8A=A8=E5=BF=85?= =?UTF-8?q?=E9=9C=80=E9=85=8D=E7=BD=AE=E8=A1=A8=E9=A6=96=E5=88=97=E6=94=B9?= =?UTF-8?q?=E6=8F=8F=E8=BF=B0=E5=90=8D=EF=BC=8C=E9=94=AE=E8=B5=B0=20PARAM?= =?UTF-8?q?=20=E5=BC=95=E7=94=A8=EF=BC=88=E4=BF=AE=2097=20=E5=BC=95?= =?UTF-8?q?=E5=85=A5=E7=9A=84=E9=97=A8=E7=A6=81=E7=BA=A2=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit check-docs 的 PARAM 定义判定按表格首列计数，重复键名导致三项参数报重复定义。 --- docs/reference.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/reference.md b/docs/reference.md index b2b746e..e9ef679 100644 --- a/docs/reference.md +++ b/docs/reference.md @@ -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 解析失败拒绝启动，无需自检代码。