ASP.NET Core+HTMX：返回NoContent却带响应体的问题排查与解决

• ASP.NET Core自带的错误处理中间件会自动拦截400-599区间的状态码，不管你的控制器动作有没有显式渲染视图，都会自动生成错误页内容并注入到响应体中。
• 这个中间件默认不会区分普通请求和HTMX请求，所以HTMX发起的请求也会被强制套上错误页响应体，哪怕你只想返回纯状态码。

1. 针对HTMX请求跳过错误页渲染 #

在Program.cs里修改错误处理中间件的配置，检查请求头是否包含HX-Request（HTMX请求的专属标识头），如果是就只保留状态码，清空响应体：

// 处理异常错误
app.UseExceptionHandler(errorApp =>
{
    errorApp.Run(async context =>
    {
        if (context.Request.Headers.ContainsKey("HX-Request"))
        {
            // HTMX请求只返回状态码，不输出错误页
            context.Response.StatusCode = StatusCodes.Status500InternalServerError;
            await context.Response.WriteAsync(string.Empty);
            return;
        }
        // 非HTMX请求保留原有错误页逻辑
        context.Response.StatusCode = StatusCodes.Status500InternalServerError;
        context.Response.ContentType = "text/html";
        await context.Response.WriteAsync("<html><body><h1>服务器内部错误</h1></body></html>");
    });
});

// 处理400+状态码的页面
app.UseStatusCodePages(async context =>
{
    if (context.HttpContext.Request.Headers.ContainsKey("HX-Request"))
    {
        // HTMX请求清空响应体，只留状态码
        context.HttpContext.Response.ContentLength = 0;
        return;
    }
    // 非HTMX请求走常规状态码页流程
    await context.Next(context.HttpContext);
});

2. 在控制器动作里手动处理错误，避免触发全局中间件 #

在CreateCustomer动作里，直接处理验证失败或异常场景，返回空结果而非让错误冒泡到中间件：

[HttpPost]
public IActionResult CreateCustomer(CustomerViewModel model)
{
    if (!ModelState.IsValid)
    {
        Response.StatusCode = StatusCodes.Status400BadRequest;
        return new EmptyResult();
    }

    try
    {
        _customerService.Create(model);
        return NoContent();
    }
    catch (Exception ex)
    {
        _logger.LogError(ex, "创建客户失败");
        Response.StatusCode = StatusCodes.Status500InternalServerError;
        return new EmptyResult();
    }
}

用EmptyResult()可以确保响应体为空，不会被中间件篡改。

3. 验证效果 #

用浏览器开发者工具或Postman发起带HX-Request: true头的请求，触发错误状态码时，检查响应体是否为空，状态码是否正确；同时确保普通非HTMX请求仍能正常显示错误页，不影响常规用户体验。

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