diff --git a/aioj-backend-auth/pom.xml b/aioj-backend-auth/pom.xml
index 26da59f..7c99de0 100644
--- a/aioj-backend-auth/pom.xml
+++ b/aioj-backend-auth/pom.xml
@@ -19,6 +19,32 @@
     </properties>
 
     <dependencies>
+        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.8.4</version>
+        </dependency>
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+            <version>4.5.0</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-common</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
         <!-- 核心模块 -->
         <dependency>
             <groupId>cn.meowrain</groupId>
@@ -107,12 +133,6 @@
             <artifactId>spring-boot-starter-data-redis</artifactId>
         </dependency>
 
-        <!-- API文档 -->
-        <dependency>
-            <groupId>com.github.xiaoymin</groupId>
-            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-        </dependency>
-
         <!-- 开发工具 -->
         <dependency>
             <groupId>org.springframework.boot</groupId>
diff --git a/aioj-backend-common/aioj-backend-common-bom/pom.xml b/aioj-backend-common/aioj-backend-common-bom/pom.xml
index 7225b5d..b39f94d 100644
--- a/aioj-backend-common/aioj-backend-common-bom/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-bom/pom.xml
@@ -62,13 +62,6 @@
             </dependency>
 
 
-            <!-- https://mvnrepository.com/artifact/com.github.xiaoymin/knife4j-openapi3-jakarta-spring-boot-starter -->
-            <dependency>
-                <groupId>com.github.xiaoymin</groupId>
-                <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-                <version>4.5.0</version>
-            </dependency>
-
             <!-- OAuth2 Client -->
             <!-- https://mvnrepository.com/artifact/org.springframework.security/spring-security-oauth2-client -->
             <!-- https://mvnrepository.com/artifact/org.springframework.boot/spring-boot-starter-oauth2-client -->
diff --git a/aioj-backend-common/aioj-backend-common-mybatis/pom.xml b/aioj-backend-common/aioj-backend-common-mybatis/pom.xml
index 67a741f..ff68bc2 100644
--- a/aioj-backend-common/aioj-backend-common-mybatis/pom.xml
+++ b/aioj-backend-common/aioj-backend-common-mybatis/pom.xml
@@ -44,11 +44,6 @@
             <groupId>com.mysql</groupId>
             <artifactId>mysql-connector-j</artifactId>
         </dependency>
-        <!-- https://mvnrepository.com/artifact/com.github.xiaoymin/knife4j-openapi3-jakarta-spring-boot-starter -->
-        <dependency>
-            <groupId>com.github.xiaoymin</groupId>
-            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-        </dependency>
 
         <dependency>
             <groupId>org.springframework.security</groupId>
diff --git a/aioj-backend-common/aioj-backend-common-swagger/pom.xml b/aioj-backend-common/aioj-backend-common-swagger/pom.xml
new file mode 100644
index 0000000..ec11c36
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-swagger/pom.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>cn.meowrain</groupId>
+        <artifactId>aioj-backend-common</artifactId>
+        <version>1.0-SNAPSHOT</version>
+    </parent>
+
+    <groupId>cn.meowrain.aioj.backend.common.swagger</groupId>
+    <artifactId>aioj-backend-common-swagger</artifactId>
+
+    <properties>
+        <maven.compiler.source>17</maven.compiler.source>
+        <maven.compiler.target>17</maven.compiler.target>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    </properties>
+
+</project>
\ No newline at end of file
diff --git a/aioj-backend-common/aioj-backend-common-swagger/src/main/java/cn/meowrain/aioj/backend/common/swagger/Main.java b/aioj-backend-common/aioj-backend-common-swagger/src/main/java/cn/meowrain/aioj/backend/common/swagger/Main.java
new file mode 100644
index 0000000..53a9441
--- /dev/null
+++ b/aioj-backend-common/aioj-backend-common-swagger/src/main/java/cn/meowrain/aioj/backend/common/swagger/Main.java
@@ -0,0 +1,17 @@
+package cn.meowrain.aioj.backend.common.swagger;
+
+//TIP 要<b>运行</b>代码，请按 <shortcut actionId="Run"/> 或
+// 点击装订区域中的 <icon src="AllIcons.Actions.Execute"/> 图标。
+public class Main {
+    public static void main(String[] args) {
+        //TIP 当文本光标位于高亮显示的文本处时按 <shortcut actionId="ShowIntentionActions"/>
+        // 查看 IntelliJ IDEA 建议如何修正。
+        System.out.printf("Hello and welcome!");
+
+        for (int i = 1; i <= 5; i++) {
+            //TIP 按 <shortcut actionId="Debug"/> 开始调试代码。我们已经设置了一个 <icon src="AllIcons.Debugger.Db_set_breakpoint"/> 断点
+            // 但您始终可以通过按 <shortcut actionId="ToggleLineBreakpoint"/> 添加更多断点。
+            System.out.println("i = " + i);
+        }
+    }
+}
\ No newline at end of file
diff --git a/aioj-backend-gateway/pom.xml b/aioj-backend-gateway/pom.xml
index 657e0a8..4c2902b 100644
--- a/aioj-backend-gateway/pom.xml
+++ b/aioj-backend-gateway/pom.xml
@@ -50,11 +50,10 @@
             <groupId>com.alibaba.csp</groupId>
             <artifactId>sentinel-datasource-extension</artifactId>
         </dependency>
-        <!--
-        https://mvnrepository.com/artifact/com.github.xiaoymin/knife4j-openapi3-jakarta-spring-boot-starter -->
+
         <dependency>
             <groupId>com.github.xiaoymin</groupId>
-            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+            <artifactId>knife4j-gateway-spring-boot-starter</artifactId>
             <version>4.5.0</version>
         </dependency>
 
diff --git a/aioj-backend-upms/aioj-backend-upms-api/pom.xml b/aioj-backend-upms/aioj-backend-upms-api/pom.xml
index 6520d36..13b113d 100644
--- a/aioj-backend-upms/aioj-backend-upms-api/pom.xml
+++ b/aioj-backend-upms/aioj-backend-upms-api/pom.xml
@@ -18,6 +18,32 @@
     </properties>
 
     <dependencies>
+        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.8.4</version>
+        </dependency>
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+            <version>4.5.0</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-common</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
         <dependency>
             <groupId>cn.meowrain</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
diff --git a/aioj-backend-upms/aioj-backend-upms-biz/pom.xml b/aioj-backend-upms/aioj-backend-upms-biz/pom.xml
index 7c198d7..408d51d 100644
--- a/aioj-backend-upms/aioj-backend-upms-biz/pom.xml
+++ b/aioj-backend-upms/aioj-backend-upms-biz/pom.xml
@@ -18,6 +18,32 @@
     </properties>
 
     <dependencies>
+        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.8.4</version>
+        </dependency>
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+            <version>4.5.0</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-common</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
         <dependency>
             <groupId>cn.meowrain</groupId>
             <artifactId>aioj-backend-common-mybatis</artifactId>
diff --git a/aioj-backend-user-service/pom.xml b/aioj-backend-user-service/pom.xml
index cae9988..3a2924d 100644
--- a/aioj-backend-user-service/pom.xml
+++ b/aioj-backend-user-service/pom.xml
@@ -18,6 +18,32 @@
     </properties>
 
     <dependencies>
+        <!-- SpringDoc OpenAPI - 显式指定版本以兼容 Spring Boot 3.5.x -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.8.4</version>
+        </dependency>
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
+            <version>4.5.0</version>
+            <exclusions>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-webmvc-api</artifactId>
+                </exclusion>
+                <exclusion>
+                    <groupId>org.springdoc</groupId>
+                    <artifactId>springdoc-openapi-starter-common</artifactId>
+                </exclusion>
+            </exclusions>
+        </dependency>
+
         <dependency>
             <groupId>cn.meowrain</groupId>
             <artifactId>aioj-backend-common-core</artifactId>
diff --git a/pom.xml b/pom.xml
index 6a26b97..4b88ff7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -24,6 +24,7 @@
         <module>aioj-backend-ai-service</module>
         <module>aioj-backend-auth</module>
         <module>aioj-backend-upms</module>
+        <module>aioj-backend-common/aioj-backend-common-swagger</module>
     </modules>
     <properties>
         <maven.compiler.source>17</maven.compiler.source>