配置模板的参数校验方法是什么
模板参数校验在下发前拦住三类错误：缺失（必填未提供，渲染出残缺配置）、类型与范围错误（地址格式、端口区间、枚举取值不合法）、组合冲突（互斥选项被同时指定、参数之间逻辑不兼容）。校验应作为渲染的前置步骤，失败即中止，而不是渲染后靠人工比对发现。校验规则本身也要随模板演进维护，并与模板放在同一仓库，避免只有某个人知道存在哪些约束。
基本信息
| 校验三类 | 缺失、类型与范围、组合冲突 |
|---|---|
| 执行时机 | 渲染之前，失败即中止 |
| 规则位置 | 与模板同仓库维护，随模板演进更新 |
| 输出要求 | 指出参数名、违反的规则、期望取值 |
| 禁止做法 | 渲染后人工比对、只靠默认值兜底 |
典型使用场景
- 校验地址与掩码格式是否合法
- 校验端口与数值是否落在允许区间
- 校验枚举参数取值是否合法
- 校验互斥选项是否被同时指定
- 校验参数组合是否符合业务约束
校验规则表述示意
校验规则表述示意
# 必填：管理地址、目标名、站点编码 缺失即中止渲染
# 格式：地址符合约定写法，掩码合法
# 范围：数值参数落在允许区间内
# 枚举：只能取约定集合中的值
# 组合：两个互斥选项不得同时出现
# 失败输出：参数名 + 违反的规则 + 期望取值校验类型与后果
| 校验类型 | 拦住的错误 | 不校验的后果 |
|---|---|---|
| 必填校验 | 残缺配置被渲染 | 目标接受残缺配置，形成隐性错误 |
| 格式与范围 | 无效取值写入配置 | 被拒绝或行为异常 |
| 枚举校验 | 拼写错误与非法值 | 配置静默不生效 |
| 组合冲突 | 互斥选项同时生效 | 行为不可预测 |
校验规则应当可执行、可测试：把每条规则写成一个可自动断言的用例，模板演进时同步更新。仅存在于文档中的约束在实际使用中几乎必然被绕过。
依赖默认值兜底会把「忘记传参」变成「静默使用默认值」。对影响连通性、安全或数据位置的关键参数，应设为必填并在缺失时直接失败。