首页/开发/CI/CD 与发布速查/配置校验(Schema Validation)
环境与配置管理60 条

配置校验(Schema Validation)

在加载与流水线阶段校验配置结构与取值:必填项、类型、范围、互斥条件——让配置错误在启动时暴露。

CI/CD 与发布速查开发更新于 2026-10-12
手段JSON Schema、语言内类型校验(如 pydantic/serde)、启动自检
时机构建期校验模板;启动期校验最终注入值
效果错误信息指向具体字段,而不是运行中随机崩溃

Py 校验示意

Py 校验示意
from pydantic import BaseModel, PositiveInt

class DbConf(BaseModel):
    host: str
    port: PositiveInt = 5432
    pool_size: PositiveInt = 10
把「环境变量清单」也纳入校验:未知键告警,防止拼写错误静默生效为默认值。

易错点

  • 校验只覆盖必填:范围与互斥同样重要(如副本数与资源上限冲突)
  • 校验放在运行期但进程不重启:配置更新不触达,明确重载语义

数据来源与参考

  • JSON Schema 规范
  • Pydantic 文档
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌