From fd67175788cd633337297bd12347e3473add2c9d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=B4=E6=B3=BD=E5=A8=81?= <958142070@qq.com>
Date: Thu, 27 Nov 2025 17:23:52 +0800
Subject: [PATCH] =?UTF-8?q?feat(ruoyi-common-doc):=20=E9=9B=86=E6=88=90=20?=
 =?UTF-8?q?nextdoc4j=20=E4=BB=A5=E6=94=AF=E6=8C=81=E6=96=87=E6=A1=A3?=
 =?UTF-8?q?=E7=AE=A1=E7=90=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在开发环境配置文件中新增 nextdoc4j 启用开关，默认启用
- 在 ruoyi-common-doc 模块中添加 nextdoc4j springboot starter 依赖
- 在根 pom 文件中增加 nextdoc4j 版本管理以及相应的依赖导入
- 添加 nextdoc4j 相关的 bom 依赖导入，统一管理版本依赖
---
 pom.xml                                            | 10 +++++++---
 ruoyi-admin/src/main/resources/application-dev.yml |  5 +++++
 ruoyi-common/ruoyi-common-doc/pom.xml              |  5 +++--
 3 files changed, 15 insertions(+), 5 deletions(-)

diff --git a/pom.xml b/pom.xml
index b6baf1b12..d376c0f3b 100644
--- a/pom.xml
+++ b/pom.xml
@@ -20,6 +20,7 @@
         <java.version>17</java.version>
         <mybatis.version>3.5.16</mybatis.version>
         <springdoc.version>2.8.13</springdoc.version>
+        <nextdoc4j.version>1.1.1</nextdoc4j.version>
         <therapi-javadoc.version>0.15.0</therapi-javadoc.version>
         <fastexcel.version>1.3.0</fastexcel.version>
         <velocity.version>2.3</velocity.version>
@@ -127,10 +128,13 @@
                 <scope>import</scope>
             </dependency>
 
+            <!--nextdoc4j - bom 管理-->
             <dependency>
-                <groupId>org.springdoc</groupId>
-                <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
-                <version>${springdoc.version}</version>
+                <groupId>top.nextdoc4j</groupId>
+                <artifactId>nextdoc4j-dependencies</artifactId>
+                <version>${nextdoc4j.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
             </dependency>
 
             <dependency>
diff --git a/ruoyi-admin/src/main/resources/application-dev.yml b/ruoyi-admin/src/main/resources/application-dev.yml
index 1b52fab96..dcd6b6e13 100644
--- a/ruoyi-admin/src/main/resources/application-dev.yml
+++ b/ruoyi-admin/src/main/resources/application-dev.yml
@@ -186,6 +186,11 @@ sms:
       sdk-app-id: 您的sdkAppId
 
 
+# nextdoc4j 配置 - dev 启动 prod不配置默认不启动
+nextdoc4j:
+  # 是否启用
+  enabled: true
+
 --- # 三方授权
 justauth:
   # 前端外网访问地址
diff --git a/ruoyi-common/ruoyi-common-doc/pom.xml b/ruoyi-common/ruoyi-common-doc/pom.xml
index c6199a17c..add07ee5c 100644
--- a/ruoyi-common/ruoyi-common-doc/pom.xml
+++ b/ruoyi-common/ruoyi-common-doc/pom.xml
@@ -21,9 +21,10 @@
             <artifactId>ruoyi-common-core</artifactId>
         </dependency>
 
+        <!-- Nextdoc4j 集成 -->
         <dependency>
-            <groupId>org.springdoc</groupId>
-            <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+            <groupId>top.nextdoc4j</groupId>
+            <artifactId>nextdoc4j-springboot3-starter</artifactId>
         </dependency>
 
         <dependency>