NextDoc4j v1.3.0 发布 前端重构接口详情和在线调试,后端适配网关 MVC 模式

NextDoc4j v1.3.0

NextDoc4j 1.3.0 是一次前后端都比较扎实的升级。

这一版后端重点补齐了 Spring Cloud Gateway WebMvc 场景的聚合文档能力，同时把网关路由发现、Starter 体系和 Spring Boot 3/4 的公共能力做了一次更清晰的重构；前端则围绕接口详情、在线调试、导出能力和聚合检索做了完整增强。

版本亮点

• 后端新增 Spring Cloud Gateway WebMvc 聚合文档支持，WebFlux / WebMvc 现在都可以走统一的聚合链路。
• 后端引入中立路由模型与 nextdoc4j-plugin-gateway-core，统一路由发现、元数据解析与文档入口生成逻辑。
• 后端新增 nextdoc4j-common，并按 Spring Boot 3/4、WebFlux/WebMvc 重新拆分 Starter，接入边界更清晰。
• 前端新增完整接口详情工作台，支持参数视图、模式视图、请求/响应 JSON 示例、多示例切换，以及 oneOf / allOf / anyOf 展示。
• 前端新增请求/响应 TS 代码示例面板和 TS 实体代码生成能力。
• 前端新增更完整的在线调试能力与文档导出中心，支持聚合服务导出和 Markdown / HTML / OpenAPI JSON / Docx / PDF 多格式输出。

后端更新

• 新增 gateway-webmvc-starter、WebMvc 路由定位器、响应重写过滤器与自动配置桥接，补齐 Servlet / WebMvc 网关场景的聚合文档能力。
• 新增 NextDoc4jGatewayRouteDefinitionLocator、GatewayRouteDefinition、GatewayPredicateDefinition 等中立模型，统一 WebFlux / WebMvc 的路由抽象。
• 新增 nextdoc4j-common-springboot3/4，将基础认证、扩展解析、资源处理等公共能力下沉，减少重复实现。
• 优化网关自动发现链路，增强 metadata、Path Predicate、URI、服务 context-path 等多来源组合解析能力。
• 优化 Spring Boot 3/4 的模块层级、父 POM 和 Starter 边界，依赖结构更清晰。

前端更新

• 新增接口详情工作台与实体模型 JSON 示例，增强详情页的结构化表达能力。
• 新增高级在线调试，支持 Path / Query / Header / Cookie / Body 联动编辑、请求缓存、Content-Type 切换、form-data / file 上传，以及图片 / Base64 / 二进制响应处理。
• 新增文档导出中心，支持全局参数管理、自定义导出范围、聚合服务导出和多格式导出。
• 重构接口详情页布局与交互，优化 JSON Viewer、大响应渲染、导出预览与全局搜索体验。
• 补充系统暗黑模式跟随、首页版本号从后端 x-nextdoc4j.version 读取，并统一 OpenAPI 与在线调试超时配置。

问题修复

• 修复 Spring Cloud Gateway MVC 场景下原先仅覆盖 WebFlux 的能力缺口。
• 修复不同 Starter 中通用类分散、装配边界混杂的问题。
• 修复路由元数据解析在 routesMap、空谓词、嵌套 metadata、缺省 URI 等场景下的兼容性边界。
• 修复在线调试 URL 解析、form-data 文件上传展示、内容类型处理等异常。
• 修复接口详情页展开闪动、状态重置、空 JSON 结构展示与嵌套参数必填识别问题。
• 修复 Schema 解析边界、多内容类型响应渲染、聚合模式错误命中与水印开关不生效等问题。

依赖更新

• Spring Boot 3：3.5.11 -> 3.5.13
• Spring Cloud（Boot 3）：2025.0.0 -> 2025.0.2
• Spring Boot 4：4.0.3 -> 4.0.5
• Springdoc（Boot 3）：2.8.16 -> 2.8.17
• Springdoc（Boot 4）：3.0.2 -> 3.0.3
• Swagger：2.2.45 -> 2.2.47
• Sa-Token（Boot 3）：1.44.0 -> 1.45.0

欢迎升级到 v1.3.0。
如果你在网关聚合场景下使用 NextDoc4j，这一版尤其值得更新。