配置校验是什么
配置校验在加载与流水线阶段检查配置的结构与取值：必填项、类型、范围、互斥条件，让配置错误在启动时暴露，而不是运行中随机崩溃。好校验的产出是精确到字段的错误信息；最坏情况是写错的键静默走默认值。常用手段包括 JSON Schema、语言内类型校验（pydantic、serde 等）、启动自检，以及流水线里对模板文件的检查。
基本信息
| 适用平台 | 所有读取配置的服务；K8s 侧可借准入与模式校验 |
|---|---|
| 手段 | JSON Schema、语言内类型校验、启动自检 |
| 时机 | 构建期校验模板；启动期校验最终注入值 |
| 效果 | 错误信息指向具体字段，而不是运行中随机崩溃 |
| 失败输出 | 校验失败要给出具体键名与期望类型，能直接照着修改 |
典型使用场景
- 启动自检：缺键、类型错、范围越界直接拒绝启动，避免带病运行
- 流水线检查：部署前对配置模板跑校验，坏配置不进环境
- 环境对比：核对各环境键名一致，防止「只有生产缺一个键」
- 平滑演进：新键带默认值、弃用键给告警，留迁移窗口
- 组合约束：副本数与资源上限等互斥条件的联合校验
- 配置漂移排查：用校验报错的具体键定位人为改动与模板的差异
Py 校验示意
Py 校验示意
from pydantic import BaseModel, PositiveInt
class DbConf(BaseModel):
host: str
port: PositiveInt = 5432
pool_size: PositiveInt = 10
DbConf.model_validate(payload) # 失败时抛出精确到字段的错误校验维度与后果
| 维度 | 示例 | 不校验的后果 |
|---|---|---|
| 必填 | 数据库主机 | 启动后首次请求才崩 |
| 类型 | 端口必须是整数 | 字符串端口运行期才炸 |
| 范围 | 连接池取值区间 | 负值导致连接耗尽 |
| 互斥 | 多副本需配套策略 | 滚动更新中断服务 |
把环境变量清单也纳入校验：未知键告警，防止拼写错误静默生效为默认值。
校验要在两个时机做：构建期校验模板、启动期校验最终注入值，缺一不可。