diff --git a/aioj-backend-auth/src/main/resources/application.yml b/aioj-backend-auth/src/main/resources/application.yml
index b60a8b4..e357af3 100644
--- a/aioj-backend-auth/src/main/resources/application.yml
+++ b/aioj-backend-auth/src/main/resources/application.yml
@@ -21,8 +21,8 @@ springdoc:
     operations-sorter: alpha
   group-configs:
     - group: 'default'
-      paths-to-match: '/**'
-      packages-to-scan: cn.meowrain.aioj.backend.userservice.controller
+      paths-to-match: '/api/**'
+      packages-to-scan: cn.meowrain.aioj.backend.auth.controller
 knife4j:
   basic:
     enable: true
diff --git a/aioj-backend-gateway/src/main/resources/application-dev.yml b/aioj-backend-gateway/src/main/resources/application-dev.yml
index f6453a4..b5f9fde 100644
--- a/aioj-backend-gateway/src/main/resources/application-dev.yml
+++ b/aioj-backend-gateway/src/main/resources/application-dev.yml
@@ -51,6 +51,13 @@ aioj-backend-gateway:
     - /api/v1/question/detail/**
     - /actuator/health
     - /swagger-ui/**
+    - /doc.html
+    - /doc.html/**
+    - /webjars/**
+    - /v3/api-docs/**
+    - /**/v3/api-docs/**
+    - /auth-service/**
+    - /user-service/**
 
 logging:
   level:
@@ -64,3 +71,22 @@ logging:
     org.springframework.cloud.gateway: DEBUG
     # 自定义过滤器日志
     cn.meowrain.aioj.backend.gateway: DEBUG
+
+
+knife4j:
+  gateway:
+    enabled: true
+    tags-sorter: alpha
+    operations-sorter: alpha
+    strategy: manual
+    routes:
+      - name: 认证服务
+        service-name: auth-service
+        url: /auth-service/api/v3/api-docs
+        context-path: /auth-service
+        order: 1
+      - name: 用户服务
+        service-name: user-service
+        url: /user-service/api/v3/api-docs
+        context-path: /user-service
+        order: 2
diff --git a/aioj-backend-gateway/src/main/resources/application.yml b/aioj-backend-gateway/src/main/resources/application.yml
index 76a2fd5..ec983ee 100644
--- a/aioj-backend-gateway/src/main/resources/application.yml
+++ b/aioj-backend-gateway/src/main/resources/application.yml
@@ -11,6 +11,21 @@ spring:
       server:
         webflux:
           routes:
+            # auth服务 Swagger 文档路由
+            - id: auth-service-doc
+              uri: lb://auth-service
+              predicates:
+                - Path=/auth-service/**
+              filters:
+                - StripPrefix=1
+            # user服务 Swagger 文档路由
+            - id: user-service-doc
+              uri: lb://user-service
+              predicates:
+                - Path=/user-service/**
+              filters:
+                - StripPrefix=1
+            # auth业务接口
             - id: auth-service
               uri: lb://auth-service
               predicates:
diff --git a/aioj-backend-user-service/src/main/resources/application.yml b/aioj-backend-user-service/src/main/resources/application.yml
index 4b017f9..16741ee 100644
--- a/aioj-backend-user-service/src/main/resources/application.yml
+++ b/aioj-backend-user-service/src/main/resources/application.yml
@@ -20,7 +20,7 @@ springdoc:
     operations-sorter: alpha
   group-configs:
     - group: 'default'
-      paths-to-match: '/**'
+      paths-to-match: '/api/**'
       packages-to-scan: cn.meowrain.aioj.backend.userservice.controller
 knife4j:
   basic: