背景
系统已具备基础功能,但参数和配置校验仍不完整,容易在运行时暴露低级错误。
问题
- 接口参数校验分散且不一致
- 环境变量缺失可能在运行中才触发错误
- 缺乏“启动即失败”的配置门禁
目标
实现统一参数校验与配置校验机制,在启动阶段尽早发现问题。
建议改造
- 统一请求参数校验策略(binding + 自定义 validator)
- 新增配置校验函数(关键 env 必填、格式合法)
- 启动时执行配置校验并失败退出
- 输出清晰的配置错误信息(便于定位)
验收标准
- 关键配置缺失时服务启动失败
- 参数错误统一返回 4xx 与规范错误码
- 主要接口(runs/chat/auth)覆盖参数校验测试
背景
系统已具备基础功能,但参数和配置校验仍不完整,容易在运行时暴露低级错误。
问题
目标
实现统一参数校验与配置校验机制,在启动阶段尽早发现问题。
建议改造
验收标准