使用xades4j库时含变音符号的XML签名验证失败求助

这个问题我之前也碰到过，核心原因就是签名和验证阶段的XML字符编码不一致，导致摘要计算结果不匹配。XML里的é、ñ这类非ASCII字符对编码非常敏感，只要有一个环节用了错误的编码（比如系统默认的ISO-8859-1），就会出现你看到的验证失败。

关键解决方案：全程强制使用UTF-8编码 #

XML文件声明了encoding="UTF-8"，所以签名和验证的整个流程必须严格遵循UTF-8编码，不能依赖系统默认编码。

1. 读取/写入XML时明确指定UTF-8

不要用默认的FileReader/FileWriter（它们会用系统默认编码），改用InputStreamReader/OutputStreamWriter并指定StandardCharsets.UTF_8：

签名时读取XML的正确方式：

DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
dbf.setNamespaceAware(true);
// 强制用UTF-8读取XML文件
try (InputStreamReader reader = new InputStreamReader(new FileInputStream("input.xml"), StandardCharsets.UTF_8)) {
    Document doc = dbf.newDocumentBuilder().parse(reader);
    // 后续签名逻辑...
} catch (Exception e) {
    e.printStackTrace();
}

验证时读取已签名XML的正确方式：

try (InputStreamReader reader = new InputStreamReader(new FileInputStream("signed.xml"), StandardCharsets.UTF_8)) {
    Document signedDoc = dbf.newDocumentBuilder().parse(reader);
    XadesVerifier verifier = // 初始化你的验证器
    verifier.verify(signedDoc);
} catch (Exception e) {
    e.printStackTrace();
}

2. 确保XML文件实际编码与声明一致

检查你的XML文件是否真的以UTF-8编码保存：

• 如果是用文本编辑器保存的，要选择"UTF-8"（尽量不要选带BOM的UTF-8，部分解析器可能不兼容）
• 避免将文件保存为GBK、ISO-8859-1等其他编码却声明UTF-8，这会导致解析时字符乱码，进而影响摘要计算。

3. 检查XAdES4J底层XML处理配置

XAdES4J依赖Apache XML Security库，确保底层解析器没有强制使用其他编码。如果是通过字符串处理XML（比如从内存生成XML），要确保字符串是UTF-8编码的，不要在转换字节数组时用错编码：

// 从字符串生成XML时，指定UTF-8编码
String xmlContent = "...";
InputStream is = new ByteArrayInputStream(xmlContent.getBytes(StandardCharsets.UTF_8));
Document doc = dbf.newDocumentBuilder().parse(is);

为什么这样能解决问题？ #

数字签名的摘要（Digest）是基于XML的字节流计算的。如果签名时用UTF-8读取XML（特殊字符占2字节），而验证时用ISO-8859-1读取（特殊字符被错误解析为1字节），生成的字节流完全不同，自然会导致摘要不匹配，验证失败。全程统一UTF-8编码就能保证字节流一致，摘要计算结果相同，验证就能通过。

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