为xsd.exe生成类与XmlSerializer创建的XML签名及解决验证异常

一、Signature元素未声明的原因及修复 #

你猜的没错，问题根源就是SignedXml默认生成的<Signature>元素不带指定命名空间，而你的Schema里的Signature属于http://www.w3.org/2000/09/xmldsig#命名空间，XML验证时找不到对应声明，所以报错。

修复方法很直接：让SignedXml生成的Signature节点带上正确的命名空间，有两种常用方式：

1. 签名后手动修正节点命名空间
   先序列化PackageEnvelope得到XmlDocument，完成签名后找到生成的<Signature>节点，直接设置它的NamespaceURI为http://www.w3.org/2000/09/xmldsig#，同时确保Schema里的xmldsig命名空间前缀（比如常用的ds）和节点前缀一致。
   代码示例：

   // 序列化PackageEnvelope得到XmlDocument
   XmlDocument doc = new XmlDocument();
   using (MemoryStream ms = new MemoryStream())
   {
       XmlSerializer serializer = new XmlSerializer(typeof(PackageEnvelope));
       serializer.Serialize(ms, envelope);
       ms.Position = 0;
       doc.Load(ms);
   }
   
   // 执行SignedXml签名逻辑
   SignedXml signedXml = new SignedXml(doc);
   signedXml.SigningKey = cert.PrivateKey;
   // 添加签名引用等步骤
   signedXml.ComputeSignature();
   
   // 获取签名节点并修正命名空间
   XmlElement signatureElement = signedXml.GetXml();
   signatureElement.SetAttribute("xmlns:ds", "http://www.w3.org/2000/09/xmldsig#");
   signatureElement.NamespaceURI = "http://www.w3.org/2000/09/xmldsig#";
   
   // 将修正后的节点插入到XML文档的正确位置
   XmlNode parentNode = doc.SelectSingleNode("//PackageEnvelope");
   parentNode.AppendChild(doc.ImportNode(signatureElement, true));
   

2. 生成签名时指定命名空间上下文
   如果你用的是.NET Framework 4.7.2及以上版本，可以在创建SignedXml时传入带有命名空间管理器的XmlDocument，确保签名过程中自动使用正确的命名空间。

二、是否应该用生成类中的Signature字段完成签名 #

必须用生成类里的Signature字段，别直接往XML里插节点。原因是xsd.exe生成的类和Schema强绑定，直接插入的节点不符合类的结构映射，不仅会导致验证失败，后续反序列化也会出问题。

正确流程是：

1. 构造好PackageEnvelope对象（除Signature字段外的其他内容填充完毕）
2. 将PackageEnvelope中需要签名的内容序列化成XML片段，用SignedXml生成签名的XML内容
3. 用XmlSerializer把签名的XML片段反序列化成生成类中对应的Signature类型实例
4. 将这个实例赋值给PackageEnvelope的Signature字段
5. 最后整体序列化PackageEnvelope对象，得到符合Schema要求的XML

示例代码片段：

// 构造待签名的PackageEnvelope
PackageEnvelope envelope = new PackageEnvelope();
// 填充其他字段...

// 序列化待签名内容
XmlSerializer envelopeSerializer = new XmlSerializer(typeof(PackageEnvelope));
StringWriter sw = new StringWriter();
envelopeSerializer.Serialize(sw, envelope);
XmlDocument signDoc = new XmlDocument();
signDoc.LoadXml(sw.ToString());

// 生成签名
SignedXml signedXml = new SignedXml(signDoc);
signedXml.SigningKey = cert.PrivateKey;
Reference reference = new Reference("");
reference.AddTransform(new XmlDsigEnvelopedSignatureTransform());
signedXml.AddReference(reference);
signedXml.ComputeSignature();

// 将签名节点反序列化成生成的Signature类
XmlSerializer sigSerializer = new XmlSerializer(typeof(Signature));
Signature sigObj = (Signature)sigSerializer.Deserialize(new XmlNodeReader(signedXml.GetXml()));

// 赋值给PackageEnvelope的Signature字段
envelope.Signature = sigObj;

// 最终序列化得到合法XML
using (FileStream fs = new FileStream("output.xml", FileMode.Create))
{
    envelopeSerializer.Serialize(fs, envelope);
}

额外注意事项 #

• 检查xsd.exe生成的Signature类是否带有[XmlElement(Namespace = "http://www.w3.org/2000/09/xmldsig#")]特性，如果没有，手动加上，确保序列化时自动带上正确的命名空间。
• 确保Schema中导入xmldsig命名空间时指定了前缀（比如xmlns:ds="http://www.w3.org/2000/09/xmldsig#"），这样生成的XML里的Signature元素会自动带上ds:前缀，和Schema匹配。

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