From ade4beacdb4df48af4e7ba6302564b8004ee4808 Mon Sep 17 00:00:00 2001
From: xiangning <xiangning@buildflow.local>
Date: Fri, 3 Jul 2026 09:42:38 +0800
Subject: [PATCH] =?UTF-8?q?fix(middleware):=20=E8=A7=A3=E5=86=B3Swagger?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=E6=97=A0=E6=B3=95=E6=AD=A3=E5=B8=B8=E6=98=BE?=
 =?UTF-8?q?=E7=A4=BA=E7=9A=84=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加 /swagger 路径到 ApiResponseMiddleware 的 PassthroughPrefixes 列表
- 确保 Swagger/OpenAPI 文档保持原始结构不被包裹成统一响应格式
- 避免 Swagger UI 无法识别 openapi 字段导致的文档加载失败
---
 src/BuildFlow.Host/BuildFlowHostModule.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/BuildFlow.Host/BuildFlowHostModule.cs b/src/BuildFlow.Host/BuildFlowHostModule.cs
index 9a71226..351b635 100644
--- a/src/BuildFlow.Host/BuildFlowHostModule.cs
+++ b/src/BuildFlow.Host/BuildFlowHostModule.cs
@@ -108,6 +108,8 @@ public class BuildFlowHostModule : AbpModule
         services.Configure<BuildFlow.Shared.Api.ApiResponseMiddlewareOptions>(opts =>
         {
             opts.PassthroughPrefixes.Add("/api/files/download");
+            // Swagger/OpenAPI 文档必须保持原始结构，不能包裹成 { code, data, message }，否则 Swagger UI 无法识别 openapi 字段。
+            opts.PassthroughPrefixes.Add("/swagger");
         });
     }