C# 类对象序列化为XML SOAP时出现生成XML文档无效错误

这个异常的根本原因是SOAP格式序列化的结构规则不匹配：XML文档的Epilog阶段指的是根元素闭合后的区域，该区域仅允许写入注释、处理指令等非元素内容，你当前的序列化逻辑在根元素闭合后仍尝试写入新的元素节点，违反了XML结构规范。

常见触发场景：

• AddressValidationRequest类中的集合/数组属性未标记SOAP专属序列化特性，SOAP编码的数组序列化需要额外的外层包裹节点，未配置时序列化器会将数组元素直接写到根节点外的Epilog区域
• 自定义类未添加[SoapRoot]特性，序列化器无法正确识别根节点的边界
• 直接使用TextWriter序列化SOAP映射对象，没有做XML结构校验

方案1：给实体类添加SOAP序列化特性 #

为你的自定义类和属性标记SOAP专属序列化特性，明确序列化结构：

// 类上添加SoapRoot特性指定根节点配置
[SoapRoot(Namespace = "http://你的业务命名空间", ElementName = "AddressValidationRequest")]
public class AddressValidationRequest
{
    // 普通属性加SoapElement指定节点名
    [SoapElement(ElementName = "ReceiveName")]
    public string ReceiveName { get; set; }

    // 集合属性必须加SoapArray和SoapArrayItem明确数组结构
    [SoapArray(ElementName = "AddressLines")]
    [SoapArrayItem("Line", typeof(string))]
    public List<string> AddressLineList { get; set; }

    // 其他属性以此类推
}

方案2：调整序列化代码，显式控制XML写入 #

如果需要生成完整的SOAP信封格式，建议使用XmlWriter手动控制外层结构，避免结构溢出：

XmlTypeMapping myTypeMapping = new SoapReflectionImporter().ImportTypeMapping(typeof(AddressValidationRequest));
XmlSerializer serializer = new XmlSerializer(myTypeMapping);

// 配置XmlWriter参数
var xmlSettings = new XmlWriterSettings
{
    Indent = true,
    Encoding = Encoding.UTF8,
    OmitXmlDeclaration = false
};

using (var xmlWriter = XmlWriter.Create(filename, xmlSettings))
{
    // 手动写入SOAP信封外层结构
    xmlWriter.WriteStartDocument();
    xmlWriter.WriteStartElement("soap", "Envelope", "http://schemas.xmlsoap.org/soap/envelope/");
    xmlWriter.WriteStartElement("soap", "Body", "http://schemas.xmlsoap.org/soap/envelope/");
    
    // 序列化对象到SOAP Body内
    serializer.Serialize(xmlWriter, request);
    
    // 闭合所有外层节点
    xmlWriter.WriteEndElement();
    xmlWriter.WriteEndElement();
    xmlWriter.WriteEndDocument();
}

方案3：添加空命名空间实例避免结构溢出 #

如果仅需要序列化SOAP编码的对象片段不需要完整信封，调用序列化方法时传入空命名空间实例即可：

XmlSerializerNamespaces emptyNs = new XmlSerializerNamespaces();
emptyNs.Add("", "");

using (TextWriter writer = new StreamWriter(filename))
{
    serializer.Serialize(writer, request, emptyNs);
}

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