.NET Core 2.1部署IIS后，如何用web.config显示完整错误信息？

哦，这个问题我之前帮不少开发者排查过——ASP.NET Core 不像传统 ASP.NET 那样依赖 <system.web> 里的配置，你现在写的 <customErrors mode="Off" /> 对 Core 应用完全不起作用，这就是为啥重启 IIS 后没效果的原因。要通过 web.config 配合应用设置获取详细错误，得按 Core 的规则来：

1. 修正web.config配置 #

把你现有的配置替换成针对ASP.NET Core的版本，核心是调整 <system.webServer> 里的 <aspNetCore> 节点，同时保留 httpErrors 配置：

<configuration>
  <system.webServer>
    <!-- 让IIS不替换详细错误，直接传递给应用处理 -->
    <httpErrors errorMode="Detailed" />
    <!-- 配置ASP.NET Core运行参数，可选设置环境变量开启开发模式 -->
    <aspNetCore processPath="dotnet" arguments=".\YourAppName.dll" 
                stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout"
                hostingModel="inprocess">
      <!-- 临时设置开发环境，让应用返回详细错误（生产环境建议用完改回Production） -->
      <environmentVariables>
        <environmentVariable name="ASPNETCORE_ENVIRONMENT" value="Development" />
      </environmentVariables>
    </aspNetCore>
  </system.webServer>
</configuration>

关键注意点： #

• 替换 YourAppName.dll 为你实际的应用程序集名称
• 确保网站根目录下存在 logs 文件夹，且IIS应用池账号有该文件夹的写入权限，否则日志无法生成
• <aspNetCore> 节点的 hostingModel 如果是 outofprocess，配置逻辑依然适用，但 inprocess 是当前推荐的托管模式

2. 配合应用内的错误处理中间件 #

光改web.config还不够，ASP.NET Core的错误展示由应用自身的中间件控制，你需要在 Program.cs 里确保开发环境下启用了详细错误页面：

var builder = WebApplication.CreateBuilder(args);

// 添加你的服务配置（比如Controllers、Razor Pages等）
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 环境判断：开发环境显示详细错误页面
if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}
else
{
    // 生产环境默认的错误处理（如果临时需要看详细错误，可以注释掉下面两行，临时启用UseDeveloperExceptionPage）
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

// 其他中间件配置（比如路由、静态文件等）
app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();
app.UseAuthorization();

app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

3. 生效步骤 #

修改完配置后，不要只重启网站，建议：

• 手动创建 logs 文件夹（如果还没创建）
• 回收IIS应用池，或者直接重启IIS服务（命令行执行 iisreset）

额外提示 #

如果是生产环境，不建议长期将 ASPNETCORE_ENVIRONMENT 设置为 Development，更安全的方式是：

• 保持环境为 Production
• 通过 stdoutLogFile 生成的日志文件查看详细错误信息
• 或者在应用内配置自定义错误页面，同时将错误日志写入专业日志系统（比如Serilog、NLog等）

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