ASP.NET Core：如何在中间件中设置XMLHttpRequest.statusText（404场景）

嘿，这个问题我刚好踩过坑！在ASP.NET Core里确实砍掉了老版本ASP.NET里的HttpResponse.StatusDescription属性，但咱们完全可以通过响应特征（Feature）来实现需求——浏览器的XMLHttpRequest.statusText其实直接对应HTTP响应状态行里的原因短语（Reason-Phrase），比如默认404对应的Not Found就是这个东西。

核心逻辑 #

HTTP响应的状态行格式是 HTTP/1.1 404 Not Found，最后那段Not Found就是原因短语，浏览器会把它直接赋值给XMLHttpRequest.statusText。在ASP.NET Core中，我们需要通过IHttpResponseFeature接口来修改这个短语。

中间件实现代码 #

下面是一个完整的自定义中间件示例，专门处理404状态下的自定义statusText：

public class CustomStatusTextMiddleware
{
    private readonly RequestDelegate _next;

    public CustomStatusTextMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 先让后续中间件处理请求逻辑
        await _next(context);

        // 检查响应是否是404
        if (context.Response.StatusCode == StatusCodes.Status404NotFound)
        {
            // 获取响应特征对象来修改原因短语
            var responseFeature = context.Features.Get<IHttpResponseFeature>();
            if (responseFeature != null)
            {
                // 这里设置的文本，就是前端能拿到的statusText
                responseFeature.ReasonPhrase = "您要找的页面飞走啦~";
            }
        }
    }
}

// 写个扩展方法，方便在Program.cs里注册中间件
public static class CustomStatusTextMiddlewareExtensions
{
    public static IApplicationBuilder UseCustomStatusText(this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<CustomStatusTextMiddleware>();
    }
}

然后在Program.cs里注册这个中间件（注意顺序，建议放在路由之前）：

var app = builder.Build();

// 注册自定义状态文本中间件
app.UseCustomStatusText();

// 其他常规中间件
app.UseRouting();
app.UseAuthorization();
app.MapControllers();

app.Run();

几个要注意的点 #

• 中间件顺序：这个中间件要放在会产生404响应的中间件前面吗？不对，我们是在后续中间件处理完请求后，修改已生成的响应的原因短语，所以要确保它能捕获到后续中间件输出的404状态，顺序上放在路由、MVC等中间件之前就可以。
• 浏览器兼容性：部分现代浏览器可能对原因短语的长度有限制，或者在跨域场景下可能会截断自定义文本，建议保持文本简洁明了。
• 别搞混响应头：你之前猜测是响应头，但其实真不是，statusText和任何HTTP头字段都没关系，它直接来自响应状态行的原因短语。

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