全栈工程化

给接口文档生成流程加一道校验,没写文档的接口别想进测试环境

后端联调最烦接口文档缺字段,这本质是流程问题。解决方案是在CI/CD流水线中加入文档校验,与lint和单测同级,不合格则构建失败。具体通过ArchUnit在编译期扫描源码,检查Controller方法的@Operation注解及入参、返回值对象的@Schema注解是否完整,并可在集成测试阶段对生成的OpenAPI文档做二次校验。