如何调试子文件夹部署的ASPNET Core应用及处理路径跳转问题

一、本地子路径调试配置 #

Kestrel 实现方案（优先推荐） #

1. 打开项目根目录下的 Properties/launchSettings.json 文件，找到 Kestrel 对应的启动配置节点，修改配置如下：

"profiles": {
  "http": {
    "commandName": "Project",
    "dotnetRunMessages": true,
    "launchBrowser": true,
    "launchUrl": "subfolder", // 启动时自动打开子路径
    "applicationUrl": "http://localhost:5000;https://localhost:5001",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  }
}

2. 在 Program.cs 管道配置的最开头添加路径基础配置：

var builder = WebApplication.CreateBuilder(args);
// ... 其他服务注册代码
var app = builder.Build();
// 注意：必须放在管道最开头，其他中间件之前
app.UsePathBase("/subfolder");
// ... 其他中间件配置，比如静态文件、路由、授权等

配置完成后启动调试，应用会自动以 https://localhost:5001/subfolder 为根路径运行，所有路由生成、重定向逻辑都会和线上部署到子文件夹的行为完全一致。

IIS Express 实现方案 #

同样修改 Properties/launchSettings.json，调整 IIS Express 相关配置：

"iisSettings": {
  "windowsAuthentication": false,
  "anonymousAuthentication": true,
  "iisExpress": {
    "applicationUrl": "https://localhost:44382",
    "sslPort": 44382,
    "applicationPath": "/subfolder" // 配置虚拟路径为子文件夹
  }
},
"profiles": {
  "IIS Express": {
    "commandName": "IISExpress",
    "launchBrowser": true,
    "launchUrl": "subfolder",
    "environmentVariables": {
      "ASPNETCORE_ENVIRONMENT": "Development"
    }
  }
}

启动时选择 IIS Express 配置即可。

二、末尾斜杠自动补全配置 #

要实现访问 https://example.com/subfolder 自动跳转到 https://example.com/subfolder/，直接在框架层面配置路由规则即可，无需依赖Web服务器配置：
在 Program.cs 服务注册阶段添加如下配置：

builder.Services.Configure<RouteOptions>(options =>
{
    // 自动为所有路由追加末尾斜杠，状态码为301永久重定向
    options.AppendTrailingSlash = true;
    options.LowercaseUrls = true; // 可选，统一URL为小写
});

该配置会自动适配 UsePathBase 设置的子路径，不会出现跳转到域名根路径的问题。

三、重定向逻辑优化建议 #

之前出现的跳转路径错误问题，除了末尾斜杠的影响，还要注意避免硬写以 / 开头的绝对路径，优先使用框架提供的路由生成方法，比如 RedirectToAction、Url.RouteUrl 等，这些方法会自动拼接 PathBase 前缀，适配不同部署路径的场景。

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