ASP.NET Core中间件已处理请求却仍记录‘请求未处理’日志

编写了一段中间件，设置了响应状态码、内容类型，并通过SendFileAsync返回内容，但日志中仍出现来自Microsoft.AspNetCore.Hosting.Diagnostics的调试信息：“Request reached the end of the middleware pipeline without being handled by application code”。代码如下：

context.Response.StatusCode = StatusCodes.Status200OK;
context.Response.ContentType = "text/html";
await context.Response.SendFileAsync(filePath);

查看源码可知该日志由以下逻辑触发：

var reachedPipelineEnd = httpContext.Items.ContainsKey(RequestUnhandledKey);
...
if (reachedPipelineEnd)
{
    LogRequestUnhandled(context);
}

且HttpContext中确实存在该标识。请问如何让ASP.NET Core认定请求已被处理？手动修改该标识过于取巧，求正确解决方案。

• 短路请求管道：处理完响应（执行完SendFileAsync）后，不要调用await next(context);。如果你的中间件继续调用后续中间件，请求会流经整个管道直到末尾，即便已经发送了响应，ASP.NET Core仍会判定请求未被应用代码处理，从而输出该调试日志。这是最核心的解决步骤，符合ASP.NET Core中间件管道的设计逻辑——当中间件处理完请求后，应终止管道流转。

• 确保响应正常启动：SendFileAsync成功执行时，会自动将context.Response.HasStarted设为true，这是ASP.NET Core判断请求已被处理的关键依据之一。如果SendFileAsync抛出异常（比如文件路径无效、文件不存在），响应未正常启动，仍会触发日志，所以要确保文件路径有效，必要时添加异常捕获与处理逻辑。

手动修改HttpContext.Items中的内部标识确实不推荐，属于依赖框架实现细节的取巧做法，后续版本可能失效。而上述两种方式是遵循框架设计的标准解决方案。

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