用途:在 Quarkus 应用的 REST 边界应用校验最佳实践,适用于添加校验支持、审查校验规则、改进请求校验、添加自定义约束、校验 @ConfigMapping 属性,以及用 ExceptionMapper 改进校验错误映射。
主要能力:DTO 与命令模型上的 Bean Validation 注解;Jakarta REST 资源中的 @Valid 与边界校验;校验分组与自定义约束;面向客户端安全的校验错误映射;跨端点一致处理非法输入。
使用方式:先阅读 references/403-frameworks-quarkus-validation.md 并检查项目现状,明确目标与最小安全改动集,再按参考模式与项目约定实现或重构校验代码,最后运行构建与测试并汇报结果。
约束与限制:应用改动前必须确保项目可编译,需先运行 ./mvnw compile 或 mvn compile;若编译失败立即停止。改进后运行 ./mvnw clean verify 或 mvn clean verify 进行验证。应基于参考规则与正反示例给出建议。详细规则、示例与限制见参考文件。