ASP.NET Core：实际为500错误时IIS Express却显示404？原因何在？

云上老周

2026-5-8

IIS Express返回404而非500错误的原因及解决办法

我来帮你捋清楚这个问题：你用ASP.NET Core 3.1创建的Web API，在DI无法解析仓储类抛出异常时，Kestrel能正常返回500错误并显示异常详情，但IIS Express却返回404页面，核心问题出在启动URL配置和异常发生的时机上，咱们一步步拆解：

问题场景回顾

当DI无法创建数据仓储类抛出异常时，Firefox开发者工具网络日志显示IIS Express返回HTTP 404状态码，而切换到Kestrel服务器则能显示原始异常（500错误）。

你的代码片段

WebConfiguration类

public class WebConfiguration {
    public void ConfigureServices(IServiceCollection services) {
        services
            .AddSwaggerGen()
            .AddControllers()
            ;
    }
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env, Options options) {
        Context.ConnectionString = options.DbConStr;
        if (env.IsDevelopment())
            app.UseDeveloperExceptionPage();
        app
            .UseHttpsRedirection()
            .UseRouting()
            .UseAuthorization()
            .UseEndpoints(endpoints => endpoints.MapControllers())
            .UseSwagger()
            ;
        if (env.IsDevelopment())
            app.UseSwaggerUI();
    }
}

UsersController类

[Route("/[controller]")]
[ApiController]
public class UsersController : ControllerBase {
    private readonly IUserAccess _repository;
    public UsersController(IUserAccess repository) => _repository = repository;
    [HttpGet]
    public ICollection<User> Get() => _repository.Get();
    [HttpGet("{familyName}")]
    public ICollection<User> Get(string familyName) => _repository.Get(familyName);
}

launchsettings.json配置

{
    "iisSettings": {
        "windowsAuthentication": false,
        "anonymousAuthentication": true,
        "iisExpress": {
            "applicationUrl": "http://localhost:52772/swagger",
            "sslPort": 0
        }
    },
    "$schema": "http://json.schemastore.org/launchsettings.json",
    "profiles": {
        "IIS Express": {
            "commandName": "IISExpress",
            "launchBrowser": true,
            "environmentVariables": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            }
        },
        "WebAPI": {
            "commandName": "Project",
            "launchBrowser": true,
            "environmentVariables": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            },
            "applicationUrl": "https://localhost:5001;http://localhost:5000"
        }
    }
}

问题根源分析

异常发生在请求处理早期：DI解析UsersController构造函数依赖时抛出的异常，属于路由匹配完成后、Action执行前的早期异常。此时开发者异常页面中间件本应捕获并渲染，但你的IIS Express配置拖了后腿。
启动URL配置错误：你把IIS Express的applicationUrl直接设为http://localhost:52772/swagger，当异常发生时，ASP.NET Core试图渲染开发者异常页面，但请求的基础路径是/swagger，导致异常页面的资源路径解析失败，IIS Express找不到对应的页面，最终返回404。
中间件顺序小问题：虽然你已经加了UseDeveloperExceptionPage()，但UseSwaggerUI()的位置不影响核心问题，不过确保异常页面中间件在最前面是关键。

解决办法

1. 修正launchsettings.json的URL配置

把applicationUrl改为根路径，用launchUrl指定启动后自动打开Swagger页面，这样既不影响开发体验，又能保证异常页面正常加载：

{
    "iisSettings": {
        "windowsAuthentication": false,
        "anonymousAuthentication": true,
        "iisExpress": {
            "applicationUrl": "http://localhost:52772",
            "sslPort": 0
        }
    },
    "$schema": "http://json.schemastore.org/launchsettings.json",
    "profiles": {
        "IIS Express": {
            "commandName": "IISExpress",
            "launchBrowser": true,
            "launchUrl": "swagger", // 用launchUrl指定打开的页面
            "environmentVariables": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            }
        },
        "WebAPI": {
            "commandName": "Project",
            "launchBrowser": true,
            "environmentVariables": {
                "ASPNETCORE_ENVIRONMENT": "Development"
            },
            "applicationUrl": "https://localhost:5001;http://localhost:5000"
        }
    }
}

2. 确保中间件顺序正确

UseDeveloperExceptionPage()必须是第一个被调用的中间件，这样才能捕获所有后续中间件的异常——你当前的代码已经做到了，但可以再确认一下：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env, Options options) {
    Context.ConnectionString = options.DbConStr;
    // 必须放在最前面，保证能捕获所有后续异常
    if (env.IsDevelopment())
        app.UseDeveloperExceptionPage();
    
    app
        .UseHttpsRedirection()
        .UseRouting()
        .UseAuthorization()
        .UseEndpoints(endpoints => endpoints.MapControllers())
        .UseSwagger();
    
    if (env.IsDevelopment())
        app.UseSwaggerUI();
}

3. 重启IIS Express和Visual Studio

有时候VS会缓存launchsettings配置，重启后确保ASPNETCORE_ENVIRONMENT确实是Development环境，这样开发者异常页面才会生效。

这样调整后，当DI再次抛出异常时，IIS Express就会正确返回500错误并显示开发者异常页面了。

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