From d9e729e1a832c6a6f20589979b0e0b21ad2c0533 Mon Sep 17 00:00:00 2001
From: YunaiV <zhijiantianya@gmail.com>
Date: Sat, 20 Sep 2025 15:19:02 +0800
Subject: [PATCH] =?UTF-8?q?fix=EF=BC=9A=E3=80=90framework=20=E6=A1=86?=
 =?UTF-8?q?=E6=9E=B6=E3=80=91=20app-api=20=E5=89=8D=E7=BC=80=E4=B8=8D?=
 =?UTF-8?q?=E7=94=9F=E6=95=88=EF=BC=8C=E9=83=BD=E6=98=AF=E4=BD=BF=E7=94=A8?=
 =?UTF-8?q?=20admin-api?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../config/YudaoSwaggerAutoConfiguration.java | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/yudao-framework/yudao-spring-boot-starter-web/src/main/java/cn/iocoder/yudao/framework/swagger/config/YudaoSwaggerAutoConfiguration.java b/yudao-framework/yudao-spring-boot-starter-web/src/main/java/cn/iocoder/yudao/framework/swagger/config/YudaoSwaggerAutoConfiguration.java
index dec79d8eb6..ef874af3be 100644
--- a/yudao-framework/yudao-spring-boot-starter-web/src/main/java/cn/iocoder/yudao/framework/swagger/config/YudaoSwaggerAutoConfiguration.java
+++ b/yudao-framework/yudao-spring-boot-starter-web/src/main/java/cn/iocoder/yudao/framework/swagger/config/YudaoSwaggerAutoConfiguration.java
@@ -11,6 +11,7 @@ import io.swagger.v3.oas.models.parameters.Parameter;
 import io.swagger.v3.oas.models.security.SecurityRequirement;
 import io.swagger.v3.oas.models.security.SecurityScheme;
 import org.springdoc.core.customizers.OpenApiBuilderCustomizer;
+import org.springdoc.core.customizers.OperationCustomizer;
 import org.springdoc.core.customizers.ServerBaseUrlCustomizer;
 import org.springdoc.core.models.GroupedOpenApi;
 import org.springdoc.core.properties.SpringDocConfigProperties;
@@ -127,6 +128,7 @@ public class YudaoSwaggerAutoConfiguration {
                 .addOperationCustomizer((operation, handlerMethod) -> operation
                         .addParametersItem(buildTenantHeaderParameter())
                         .addParametersItem(buildSecurityHeaderParameter()))
+                .addOperationCustomizer(buildOperationIdCustomizer())
                 .build();
     }
 
@@ -158,5 +160,26 @@ public class YudaoSwaggerAutoConfiguration {
                 .schema(new StringSchema()._default("Bearer test1").name(HEADER_TENANT_ID).description("认证 Token")); // 默认：使用用户编号为 1
     }
 
+    /**
+     * 核心：自定义OperationId生成规则，组合「类名前缀 + 方法名」
+     *
+     * @see <a href="https://github.com/YunaiV/ruoyi-vue-pro/issues/957">app-api 前缀不生效，都是使用 admin-api</a>
+     */
+    private static OperationCustomizer buildOperationIdCustomizer() {
+        return (operation, handlerMethod) -> {
+            // 1. 获取控制器类名（如 UserController）
+            String className = handlerMethod.getBeanType().getSimpleName();
+            // 2. 提取类名前缀（去除 Controller 后缀，如 UserController -> User）
+            String classPrefix = className.replaceAll("Controller$", "");
+            // 3. 获取方法名（如 list）
+            String methodName = handlerMethod.getMethod().getName();
+            // 4. 组合生成 operationId（如 User_list）
+            String operationId = classPrefix + "_" + methodName;
+            // 5. 设置自定义 operationId
+            operation.setOperationId(operationId);
+            return operation;
+        };
+    }
+
 }