ASP.NET MVC调用RenderWidget致head标签渲染到body及BOM异常问题

该问题核心是RenderWidget方法返回的HTML内容携带了UTF-8 BOM（字节序标记），触发了浏览器的HTML结构自动修正逻辑，具体原因如下：

1. BOM是\uFEFF对应的三个不可见字节，当它出现在<head>节点内容范围内、或者<head>和<body>的交界位置时，浏览器会将这个不可见字符判定为<body>的内容起点，自动把原本应该在<head>内的剩余标签、以及后续所有内容都迁移到<body>节点内，和你观察到的异常现象完全吻合。
2. RenderWidget方法中返回的action.ResponseOutput.ToString()内容，来自Widget视图的渲染输出流，如果渲染视图的StreamWriter使用了默认带BOM的UTF-8编码，返回的字符串就会携带这个不可见标记。
3. 无论你在<head>还是<footer>中调用RenderWidget，只要返回内容携带BOM，都会破坏HTML结构，这也符合你在header调用其他RenderWidget也出现相同问题的现象。

• 优先修改IWidgetResult的ResponseOutput生成逻辑：如果是用StreamWriter写入视图输出，将编码构造函数从默认的new UTF8Encoding(true)（带BOM）改为new UTF8Encoding(false)（关闭BOM输出），从根源避免BOM生成。
• 临时应急可以在返回MvcHtmlString前手动剔除BOM字符，参考代码如下：

var output = action.ResponseOutput.ToString();
// 移除开头的UTF-8 BOM字符
if (output.Length > 0 && output[0] == '\uFEFF')
{
    output = output.TrimStart('\uFEFF');
}
return new MvcHtmlString(output);

• 额外排查所有Widget关联的视图文件，确认文件保存格式为「UTF-8 无BOM」，避免视图文件本身携带BOM被读取到输出流中。

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