ASP.NET Core返回Content()时Content-Length不匹配错误求助

错误信息 #

System.InvalidOperationException: Response Content-Length mismatch: too few bytes written (268 of 270).

问题场景 #

使用ASP.NET Core 7开发Web应用，错误控制器中通过Content()返回静态HTML页面时触发上述错误，代码示例：

public class ErrorController : Controller
{
  [Route("error/500")]
  public IActionResult Index()
  {
    string html = System.IO.File.ReadAllText("./path/to/error_page.html");
    return Content(html, "text/html");
  }
}

直接返回字符串return Content("500 server error");则无异常，尝试用StreamReader读取文件结果一致。

原因分析 #

核心问题是文件编码与响应字节计算的差异：

• 当用File.ReadAllText或StreamReader读取文件时，若文件是UTF-8带BOM（字节顺序标记）编码，读取过程中BOM会被自动移除，但文件原始字节数包含BOM的3个字节。
• ASP.NET Core的Content()方法会根据字符串的UTF-8字节数设置Content-Length响应头，但实际写入响应的字节是去掉BOM后的内容，导致头中声明的长度和实际写入长度不匹配，触发异常。

解决方法 #

方法1：直接返回文件流（推荐） #

使用框架内置的PhysicalFile方法直接返回文件原始字节流，框架会自动处理编码和Content-Length，无需手动读取字符串：

public class ErrorController : Controller
{
  [Route("error/500")]
  public IActionResult Index()
  {
    return PhysicalFile("./path/to/error_page.html", "text/html");
  }
}

方法2：统一编码读取与输出 #

1. 将HTML文件保存为UTF-8无BOM格式（可通过VS Code、Notepad++等编辑器设置）；
2. 读取文件时明确指定UTF-8编码，确保字符串字节数与响应输出一致：

public IActionResult Index()
{
  string html = System.IO.File.ReadAllText("./path/to/error_page.html", Encoding.UTF8);
  return Content(html, "text/html");
}

方法3：禁用自动Content-Length计算（不推荐） #

通过中间件移除Content-Length头，让框架使用分块传输编码，但会带来轻微性能损耗，仅作为临时方案：

// 在Program.cs中添加中间件
app.Use(async (context, next) =>
{
    context.Response.Headers.Remove("Content-Length");
    await next();
});

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