ASP.NET返回XNode表示的XML文档时编码异常问题求助

云原生阿岚

2026-7-8

问题原因确认与解决方案

原因确认

你的推测完全正确：

C#字符串内部编码为UTF-16，StringWriter默认的Encoding属性返回Encoding.Unicode（即UTF-16）
XDocument.Save()会根据写入器的Encoding值生成XML声明的编码属性，因此输出<?xml encoding="utf-16" ?>
ASP.NET返回ContentResult时，默认会将字符串以UTF-8编码写入响应流，导致XML声明的编码与实际传输编码不一致，引发使用者困惑

合理解决方案

方案1：自定义UTF-8编码的StringWriter

通过继承StringWriter并重写Encoding属性，让XDocument生成UTF-8的编码声明，同时保留原有代码结构：

public class Utf8StringWriter : StringWriter
{
    public override Encoding Encoding => Encoding.UTF8;
}

public ContentResult SaveXml(XDocument doc, int statusCode)
{
    StringBuilder builder = new();
    using var writer = new Utf8StringWriter(builder);
    doc.Save(writer);

    return new ContentResult 
    { 
        Content = builder.ToString(), 
        ContentType = "text/xml", 
        StatusCode = statusCode 
    };
}

方案2：返回FileResult直接输出UTF-8字节流

跳过字符串中间转换，直接将XML写入UTF-8编码的内存流，通过FileStreamResult返回，彻底避免编码不一致问题：

public FileResult SaveXml(XDocument doc, int statusCode)
{
    using var stream = new MemoryStream();
    var xmlSettings = new XmlWriterSettings
    {
        Encoding = Encoding.UTF8,
        Indent = true // 可选，用于格式化XML输出
    };
    
    using var xmlWriter = XmlWriter.Create(stream, xmlSettings);
    doc.Save(xmlWriter);
    stream.Position = 0;

    return new FileStreamResult(stream, "text/xml")
    {
        StatusCode = statusCode
    };
}

两种方案对比：