ASP.NET Core Razor Pages修改默认路由，替换Swagger为自定义首页

核心问题定位 #

根路径/自动跳转到Swagger，大多是因为Swagger UI的路由前缀被设为空字符串，抢占了Razor Pages默认首页的匹配优先级，或是中间件加载顺序配置错误导致的。

具体修复步骤 #

1. 调整Swagger UI的路由范围 #

找到Program.cs里的UseSwaggerUI配置块，把RoutePrefix设置为"swagger"，让Swagger仅通过/swagger路径访问，释放根路径给自定义页面：

app.UseSwagger();
app.UseSwaggerUI(c =>
{
    c.RoutePrefix = "swagger"; // 替换原来的string.Empty配置
    c.SwaggerEndpoint("/swagger/v1/swagger.json", "你的API名称 V1");
});

2. 确保默认页面中间件的优先级 #

在Swagger相关中间件之前，添加默认文件和静态文件中间件，保证Razor Pages的首页（比如Index.cshtml）被优先匹配：

// 放在UseSwagger()之前加载
app.UseDefaultFiles();
app.UseStaticFiles();

3. 移除强制重定向代码 #

检查Program.cs中是否存在强制将根路径重定向到Swagger的代码，比如：

app.MapGet("/", context => context.Response.Redirect("/swagger"));

如果有，直接删除该行。

4. 确认Razor Pages端点配置 #

确保MapRazorPages()已正确添加到端点配置中，且位置在Swagger中间件之后：

app.UseRouting();

// 其他中间件（授权、Swagger等）...

app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages();
});

验证修复 #

本地启动应用，访问/应直接打开自定义的Razor Pages首页，/swagger仍可正常访问Swagger文档。部署到Azure后，清空缓存再测试即可生效。

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