Azure部署DotNet Core时出现纯文本文档字符编码未声明错误

这个问题我之前帮不少开发者解决过——本地跑.NET Core项目一切正常，部署到Azure就弹出编码未声明的错误，还可能导致非ASCII字符乱码对吧？别担心，这本质是Azure环境下响应头没正确告知浏览器字符编码，下面给你几个靠谱的解决办法：

1. 全局添加编码响应头（最推荐） #

通过自定义中间件，给所有HTTP响应强制加上charset=utf-8声明，一步解决所有场景的问题。在你的Program.cs（.NET 6+顶级语句模式）里添加这段代码，注意要放在其他中间件之前：

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// 编码声明中间件，优先执行
app.Use(async (context, next) =>
{
    // 给响应的Content-Type追加编码信息
    context.Response.Headers.ContentType += "; charset=utf-8";
    await next();
});

// 后续的路由、静态文件等中间件配置...
app.MapGet("/", () => "Hello World!");

app.Run();

这样不管是API接口、静态文件还是页面，都会带上编码声明，浏览器能准确识别字符集。

2. 针对静态文件单独配置编码 #

如果问题只出在静态资源（比如HTML、TXT、JSON文件）上，可以专门给静态文件服务配置编码：

builder.Services.Configure<StaticFileOptions>(options =>
{
    options.OnPrepareResponse = ctx =>
    {
        // 给静态文件响应追加编码头
        ctx.Context.Response.Headers.ContentType += "; charset=utf-8";
    };
});

配置后，所有通过静态文件中间件返回的资源都会自动带上编码声明。

3. 在视图/控制器中手动指定编码 #

如果是MVC或Razor Pages项目，除了全局配置，还可以在具体页面或接口里单独处理：

• HTML视图：在页面的<head>标签里添加meta编码声明：

  <meta charset="UTF-8">
  

• 控制器接口：返回内容时明确指定编码：

  [HttpGet]
  public IActionResult GetContent()
  {
      // 返回带编码声明的文本内容
      return Content("包含中文、特殊字符的内容", "text/plain; charset=utf-8");
  }
  

4. 给文件添加UTF-8字节顺序标记（BOM） #

如果不想修改代码，也可以确保你的源代码、静态文件保存时带有UTF-8 BOM。在Visual Studio或VS Code中，都可以设置默认保存为带BOM的UTF-8：

• VS：工具→选项→文本编辑器→所有语言→常规，勾选“保存时将UTF-8编码的文件保存为带签名的UTF-8”
• VS Code：设置中搜索files.encoding，选择utf8并勾选files.eol为\n（或对应系统换行符），同时开启files.autoGuessEncoding

文件带BOM后，浏览器会自动识别UTF-8编码，无需额外响应头声明。

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