🎨
现代化设计
基于现代 Web 技术栈构建，采用响应式设计理念。提供清晰直观的界面布局，支持暗色/亮色主题切换，为开发者带来舒适的文档浏览体验。
NextDoc4j现代化 API 文档 UI 工具 全面替代 Swagger UI
专为 SpringDoc 和 OpenAPI 3 设计的现代化文档界面，更美观、更强大的开发体验。让 API 文档焕然一新。
Skip to content
接口详情：参数、响应结构与多响应示例集中查看 
在线调试：参数编辑、请求发送与响应结果同屏完成
🌟 为什么选择 NextDoc4j？
告别传统 Swagger UI 的局限性，拥抱现代化的 API 文档体验。NextDoc4j 不仅仅是一个 UI 替换工具，更是为 Java 开发者量身定制的文档解决方案。
✨ 核心优势
零学习成本
完全兼容 SpringDoc 和 OpenAPI 3 规范，无缝迁移现有项目
企业级定制
支持品牌化定制和主题配置，满足企业级项目需求
开发者友好
提供直观的 API 调试界面和便捷的参数测试功能
体验焕新
告别传统界面束缚，享受现代化的 API 文档浏览体验
🚀 三步即刻体验
📋 版本要求
NextDoc4j 1.4.0：统一 Boot 3 / 4 单套 Starter
推荐：Spring Boot 3.5.x 或 Spring Boot 4.x · JDK 17+
单体 nextdoc4j-spring-boot-starter，网关 nextdoc4j-gateway-spring-boot-starter，BOM nextdoc4j-bom
第一步：引入依赖（最简方式）
1.4.0：
nextdoc4j-bom只管理 NextDoc4j 自身版本；springdoc 由宿主引入（WebMvc / WebFlux 二选一）。
xml
<dependency>
<groupId>top.nextdoc4j</groupId>
<artifactId>nextdoc4j-spring-boot-starter</artifactId>
<version>1.4.0</version>
</dependency>
<!-- 宿主自行引入 springdoc UI：WebMvc 用 webmvc-ui，WebFlux 用 webflux-ui -->
<!-- Boot 3 推荐 2.8.17；Boot 4 推荐 3.0.3（也可用 springdoc-openapi-bom 统一管理） -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<version>2.8.17</version>
</dependency>推荐方式（可选）：使用 BOM 统一版本管理
xml
<!-- 放到 dependencyManagement > dependencies 中 -->
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-bom</artifactId>
<version>2.8.17</version><!-- Boot 4 请改为 3.0.3 -->
<type>pom</type>
<scope>import</scope>
</dependency>
<dependency>
<groupId>top.nextdoc4j</groupId>
<artifactId>nextdoc4j-bom</artifactId>
<version>1.4.0</version>
<type>pom</type>
<scope>import</scope>
</dependency>
<!-- 放到 dependencies 中 -->
<dependency>
<groupId>top.nextdoc4j</groupId>
<artifactId>nextdoc4j-spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>org.springdoc</groupId>
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
<!-- WebFlux：springdoc-openapi-starter-webflux-ui -->
</dependency>网关场景
引入 nextdoc4j-gateway-spring-boot-starter（1.4.0），并自行加入对应 Spring Cloud Gateway（spring-cloud-starter-gateway-server-webflux / ...-webmvc）与 springdoc UI（springdoc-openapi-starter-webflux-ui / ...-webmvc-ui）。详见 快速开始 与 网关插件。
第二步：添加配置
在 application.yml 或 application.properties 中添加配置：
yaml
nextdoc4j:
enabled: true # 是否启用 NextDoc4j，默认 false
# doc-path: /docs # 可选：自定义文档入口（默认 /doc.html）properties
nextdoc4j.enabled=true
# nextdoc4j.doc-path=/docs第三步：访问文档
启动应用后，在浏览器中访问：
http://localhost:端口/doc.html💡 提示
- 默认端口通常是
8080 - 完整地址示例：
http://localhost:8080/doc.html - 若配置了
nextdoc4j.doc-path，请使用对应路径访问 - 启用全局鉴权的项目需要配置路径白名单：文档入口与
/nextdoc/**
主界面预览
🎯 界面功能说明
- 顶部 Tab 切换：同一接口下通过
接口详情与在线调试两个 Tab 快速切换 - 接口详情：集中展示请求信息、认证方式、参数说明、响应结构与多响应示例
- 在线调试：支持 Path / Query / Header / Cookie / Body 参数编辑、请求发送与响应查看（含 SSE 流式事件）
- 调试结果：支持实时响应、响应头、实际请求等结果页签，便于定位接口问题