From 6f276a058772eda9080fec43e58f87fafa870971 Mon Sep 17 00:00:00 2001 From: yubaolee Date: Fri, 19 Sep 2025 10:25:17 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=90=9Bfix:=20=E5=A2=9E=E5=8A=A0=E6=AD=A3?= =?UTF-8?q?=E5=BC=8F=E7=8E=AF=E5=A2=83Swagger=E7=95=8C=E9=9D=A2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- OpenAuth.WebApi/OpenAuth.WebApi.csproj | 3 + OpenAuth.WebApi/Startup.cs | 35 ++++--- OpenAuth.WebApi/swagger/index.html | 135 +++++++++++++++++++++++++ 3 files changed, 155 insertions(+), 18 deletions(-) create mode 100644 OpenAuth.WebApi/swagger/index.html diff --git a/OpenAuth.WebApi/OpenAuth.WebApi.csproj b/OpenAuth.WebApi/OpenAuth.WebApi.csproj index 264adb41..fa4e5bb8 100644 --- a/OpenAuth.WebApi/OpenAuth.WebApi.csproj +++ b/OpenAuth.WebApi/OpenAuth.WebApi.csproj @@ -23,6 +23,9 @@ + + PreserveNewest + diff --git a/OpenAuth.WebApi/Startup.cs b/OpenAuth.WebApi/Startup.cs index 4df7b53b..e7e640bf 100644 --- a/OpenAuth.WebApi/Startup.cs +++ b/OpenAuth.WebApi/Startup.cs @@ -247,19 +247,6 @@ namespace OpenAuth.WebApi { loggerFactory.AddLog4Net(); - //可以访问根目录下面的静态文件 - var staticfile = new StaticFileOptions - { - FileProvider = new PhysicalFileProvider(AppContext.BaseDirectory), - OnPrepareResponse = (ctx) => - { - //可以在这里为静态文件添加其他http头信息，默认添加跨域信息 - ctx.Context.Response.Headers["Access-Control-Allow-Origin"] = "*"; - } - }; - app.UseStaticFiles(staticfile); - - //todo:测试可以允许任意跨域，正式环境要加权限 app.UseCors(builder => builder.AllowAnyOrigin() .AllowAnyMethod() @@ -271,11 +258,6 @@ namespace OpenAuth.WebApi // 启用日志追踪记录和异常友好提示 app.UseLogMiddleware(); - app.UseEndpoints(endpoints => { endpoints.MapControllers(); }); - - //配置ServiceProvider - AutofacContainerModule.ConfigServiceProvider(app.ApplicationServices); - // 只在开发环境中启用 Swagger 和 MiniProfiler if (env.IsDevelopment()) { @@ -304,6 +286,23 @@ namespace OpenAuth.WebApi }); } + app.UseEndpoints(endpoints => { endpoints.MapControllers(); }); + + //配置ServiceProvider + AutofacContainerModule.ConfigServiceProvider(app.ApplicationServices); + + //可以访问根目录下面的静态文件 + var staticfile = new StaticFileOptions + { + FileProvider = new PhysicalFileProvider(AppContext.BaseDirectory), + OnPrepareResponse = (ctx) => + { + //可以在这里为静态文件添加其他http头信息，默认添加跨域信息 + ctx.Context.Response.Headers["Access-Control-Allow-Origin"] = "*"; + } + }; + app.UseStaticFiles(staticfile); + diff --git a/OpenAuth.WebApi/swagger/index.html b/OpenAuth.WebApi/swagger/index.html new file mode 100644 index 00000000..41955942 --- /dev/null +++ b/OpenAuth.WebApi/swagger/index.html @@ -0,0 +1,135 @@ + + + + + + OpenAuth.Net + + + +
+
+

OpenAuth.Net

+

最好用的.NET开源权限工作流框架

+
+ +
+

🚀 快速开始

+

欢迎使用 OpenAuth.Net API 文档系统！这里提供了完整的 API 接口文档和在线测试功能。

+ 进入 Swagger UI + GitHub 仓库 +
+ +
+ ⚠️ 重要提示： +

在生产环境中，SwaggerUI 默认会被停用以确保安全性。如需在生产环境显示 API 文档，请在 appsettings.json 中设置 "EnableSwaggerUI": true。

+
+ +
+

📖 使用说明

+

开发环境：SwaggerUI 默认启用，可直接访问 /swagger

+

生产环境：需要在配置文件中启用，设置 "EnableSwaggerUI": true

+

认证：如果启用了 IdentityServer，请先进行 OAuth2 认证

+
+ +
+

© 2025 OpenAuth.Net - 开源 .NET 权限工作流框架

+
+
+ +