ASP.NET Core中ExceptionHandler导致POST请求返回404而非500的原因排查

这个问题我之前排查过，核心是UseExceptionHandler中间件的请求转发逻辑和你错误处理端点的方法配置不匹配导致的，具体拆解如下：

为什么POST请求会返回404？ #

当UseExceptionHandler捕获到未处理异常时，它默认会创建一个新的GET请求转发到你指定的/api/debug/error路径。如果你的错误处理端点（比如DebugController里的Error方法）只配置了[HttpGet]特性，没有支持POST方法，那么这个转发过来的请求就会因为找不到对应路由而返回404。

而GET请求之所以正常，是因为原请求是GET，转发的也是GET请求，刚好匹配你错误端点的GET路由，所以能正常返回500状态码。

解决办法 #

有两种常用的修复方式，你可以根据需求选择：

1. 让错误端点支持POST方法 #

直接给你的错误处理Action添加[HttpPost]特性，确保它能接收GET和POST两种请求：

[ApiController]
[Route("api/debug")]
public class DebugController : ControllerBase
{
    // 同时支持GET和POST请求
    [HttpGet("error")]
    [HttpPost("error")]
    public IActionResult Error()
    {
        var exceptionFeature = HttpContext.Features.Get<IExceptionHandlerPathFeature>();
        var errorMessage = exceptionFeature?.Error?.Message ?? "An unexpected error occurred";
        
        return StatusCode(StatusCodes.Status500InternalServerError, new { Message = errorMessage });
    }
}

2. 自定义异常处理逻辑（不依赖路由端点） #

如果不想通过路由端点处理异常，可以直接在UseExceptionHandler里编写处理逻辑，避免请求转发的问题：

app.UseExceptionHandler(options =>
{
    options.Run(async context =>
    {
        // 设置返回状态码为500
        context.Response.StatusCode = StatusCodes.Status500InternalServerError;
        context.Response.ContentType = "application/json";

        // 获取异常信息
        var exceptionFeature = context.Features.Get<IExceptionHandlerPathFeature>();
        if (exceptionFeature != null)
        {
            var errorResponse = new
            {
                StatusCode = 500,
                Message = exceptionFeature.Error.Message,
                Path = exceptionFeature.Path
            };

            await context.Response.WriteAsync(System.Text.Json.JsonSerializer.Serialize(errorResponse));
        }
    });
});

验证要点 #

可以先检查你的DebugController中Error方法的路由特性，确认是否只允许GET请求——这是最常见的触发原因。

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