ASP.NET Core 2.2部署IIS虚拟目录路由跳转异常求助

我之前部署ASP.NET Core应用到IIS虚拟目录时也踩过一模一样的坑，明明配置了ExceptionHandler路径，但触发异常后就是跳不到带虚拟目录的地址。给你几个亲测有效的解决方案：

1. 动态配置PathBase（避免硬编码） #

很多人会直接写app.UsePathBase("/myapp")硬编码路径，这既不灵活还可能因为中间件顺序不对导致失效。正确的做法是从IIS环境变量里动态获取路径基，不管部署在根目录还是虚拟目录都能自动适配：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // 从IIS环境变量获取路径基
    var pathBase = Environment.GetEnvironmentVariable("ASPNETCORE_IIS_PATHBASE");
    if (!string.IsNullOrWhiteSpace(pathBase))
    {
        app.UsePathBase(pathBase);
        // ASP.NET Core 2.2要确保路由中间件在PathBase之后
        app.UseRouting();
    }

    // 配置异常处理（注意顺序：PathBase要在ExceptionHandler之前）
    app.UseExceptionHandler("/Error/500");

    // 其他中间件配置
    app.UseMvc();
}

关键要记住：UsePathBase必须在UseExceptionHandler和UseMvc之前执行，否则路径基不会被应用到后续的路由逻辑里。

2. 用UrlHelper生成自适应路径（最推荐） #

如果上面的方法还是没解决问题，直接用UrlHelper来生成异常处理路径是最稳妥的——它会自动带上当前的PathBase（也就是虚拟目录前缀），完全不用关心部署环境：

public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
    // 获取UrlHelper所需的服务
    var urlHelperFactory = app.ApplicationServices.GetRequiredService<IUrlHelperFactory>();
    var httpContextAccessor = app.ApplicationServices.GetRequiredService<IHttpContextAccessor>();
    
    // 生成对应Error控制器的Error500方法路径
    var urlHelper = urlHelperFactory.GetUrlHelper(httpContextAccessor.HttpContext);
    var errorPath = urlHelper.Action("Error500", "Error");

    // 配置ExceptionHandler
    app.UseExceptionHandler(errorPath);

    // 其他中间件...
    app.UseMvc();
}

这种方式完全动态，不管你部署在根目录还是任意虚拟目录，生成的路径都会自动包含前缀，绝对不会出现跳转地址缺失虚拟目录的情况。

3. 检查细节配置 #

• 确认你的Error控制器路由没有用绝对路径：比如你现在用的[Route("Error/500")]是正确的，要是写成[Route("/Error/500")]（多了开头的斜杠），就会直接忽略PathBase。
• 检查IIS应用程序池设置：ASP.NET Core 2.2应用需要把应用程序池的托管管道模式设为“集成”，.NET CLR版本设为“无托管代码”。
• 确认虚拟目录的物理路径指向应用发布文件夹，并且给IIS_IUSRS和APP_POOL_IDENTITY配置了读取权限。

按上面的方法调整后，应该就能解决跳转路径不带虚拟目录的问题了。

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