.NET Core 6+React项目中Swagger页面显示登录页问题求助

1. 中间件顺序错误 #

.NET Core中间件按注册顺序执行，若Swagger中间件放在认证/授权中间件之后，访问Swagger路径会先被拦截跳转至登录页。

修正方式：将Swagger相关中间件移至UseAuthentication和UseAuthorization之前，确保Swagger路径优先被处理：

// 先注册Swagger中间件
app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API版本名称");
});

// 再注册认证、授权中间件
app.UseAuthentication();
app.UseAuthorization();

// 最后注册React静态文件和路由转发
app.UseStaticFiles();
app.MapFallbackToFile("index.html");

2. React路由或Fallback中间件拦截Swagger路径 #

MapFallbackToFile会将所有未匹配到的请求转发至React的index.html，若Swagger中间件在它之后注册，Swagger路径会被转发到React，而React路由未配置对应路径时就会显示登录页。

修正方式：确保Swagger中间件在MapFallbackToFile之前注册（同上述中间件顺序），让Swagger路径先被匹配处理。

3. 全局授权过滤器拦截Swagger #

若全局添加了AuthorizeFilter，所有请求包括Swagger都会被要求认证。

修正方式：给Swagger相关路径放行匿名访问：

// 给Swagger的JSON端点和UI路径取消授权要求
app.MapSwagger().RequireAuthorization(false);

// 或者仅对非Swagger路径应用认证、授权
app.UseWhen(context => !context.Request.Path.StartsWithSegments("/swagger"), appBuilder =>
{
    appBuilder.UseAuthentication();
    appBuilder.UseAuthorization();
});

4. 检查SwaggerUI配置正确性 #

确认SwaggerEndpoint的路径与实际生成的Swagger JSON文件路径一致，若路径错误可能导致SwaggerUI加载失败，但一般不会直接跳转到登录页，可作为额外排查项。

内容的提问来源于stack exchange，提问作者morteza davari