Swagger 转 Postman 时保留认证依赖与变量继承的几个关键点
Swagger 转 Postman 的关键不在结构搬运，而在认证依赖与变量继承的保留。需手动核对 security 覆盖层级、补写 OAuth2 的 pre-request script 获取 token、显式设计变量作用域避免环境覆盖 collection，并处理 server 变量默认值及多环境 token 隔离，否则转换后请求易报 401 或变量失效。
标签: #Swagger
共 3 篇文章
给接口文档生成流程加一道校验，没写文档的接口别想进测试环境
后端联调最烦接口文档缺字段，这本质是流程问题。解决方案是在CI/CD流水线中加入文档校验，与lint和单测同级，不合格则构建失败。具体通过ArchUnit在编译期扫描源码，检查Controller方法的@Operation注解及入参、返回值对象的@Schema注解是否完整，并可在集成测试阶段对生成的OpenAPI文档做二次校验。
写了个插件让 Swagger 自动把后端下划线字段转成前端驼峰，顺便标清楚映射关系
Swagger 插件自动将文档中的蛇形字段名转为驼峰，并在描述里标注映射关系，解决前后端命名风格不一致的联调痛点。文章分析了现有手动维护或前端转换方案的不足，详细介绍了基于 SpringDoc 的实现原理，包括递归处理嵌套对象、参数和响应体，并讨论了边界情况与常见问题。