修复api

2026-08-19 11:28:31 +08:00
parent bf6439888e
commit eb0ab76c83
7 changed files with 107 additions and 104 deletions
@@ -27,7 +27,10 @@ export default {
                if (apiDescriptor.deprecated) {
                    return undefined;
                }
-                const newOpId = apiDescriptor.summary?.trim() || apiDescriptor.operationId;
+                // 优先使用后端显式声明的 operationId（稳定、可读、无重名后缀），
+                // 仅在 operationId 缺失时回退到 summary。切勿用 summary 覆盖 operationId，
+                // 否则中文/长文本 summary 会变成方法名导致运行时查不到。
+                const newOpId = apiDescriptor.operationId ?? apiDescriptor.summary?.trim();
                const url = apiDescriptor.url.replace(/^\/{platform}\//, "/api/");
                // springdoc 默认把 Controller 类名转为 kebab tag（如 base-controller），
                // 而业务代码统一用 Pascal 无 Controller 的命名空间（如 Base）调用。