使用iText7向PDF添加SVG遇XmlDeclaration映射错误的原因及解决

这个错误Could not map node type: class com.itextpdf.styledxmlparser.jsoup.nodes.XmlDeclaration本质上是iText 7.1.2版本的一个已知缺陷：当你尝试解析的SVG文件包含XML声明节点（也就是开头的<?xml version="1.0" encoding="UTF-8"?>这类内容）时，iText内置的JsoupXmlParser无法识别并映射这种节点类型，从而抛出这个提示。

另外，从你的依赖配置来看，你大概率还缺少了styled-xml-parser和svg这两个核心依赖——这两个是iText处理SVG解析的必要组件，缺少它们也可能引发连带的解析问题。

这里提供几个不同场景下的解决方案，你可以根据自己的需求选择：

1. 移除SVG文件中的XML声明（最快最直接） #

直接打开你的SVG文件，删除开头的<?xml ...?>声明行。iText解析SVG时不需要这个声明，去掉之后就能避免触发这个节点映射错误。

2. 升级iText到修复该问题的版本（推荐长期方案） #

这个节点映射问题在iText 7.1.10及之后的版本中已经被官方修复了。建议你把所有iText相关依赖统一升级到同一个稳定版本（比如7.2.x系列的最新版），同时补全必要的依赖项。示例Gradle配置如下：

dependencies {
    implementation 'com.itextpdf:kernel:7.2.5'
    implementation 'com.itextpdf:io:7.2.5'
    implementation 'com.itextpdf:styled-xml-parser:7.2.5'
    implementation 'com.itextpdf:svg:7.2.5'
}

注意：一定要保证所有iText模块的版本一致，避免版本冲突导致其他问题。

3. 解析前过滤SVG内容中的XML声明（适合无法修改SVG或升级版本的场景） #

如果无法修改原始SVG文件，也暂时不能升级iText版本，可以在将SVG内容传入iText解析器之前，先用字符串处理逻辑过滤掉XML声明。比如用Java代码实现：

// 假设svgContent是读取到的SVG文件字符串
String cleanedSvg = svgContent.replaceAll("^<\\?xml.*?\\?>", "");
// 然后用cleanedSvg去创建SvgConverter的输入

这个错误多数情况下是警告级别，可能不会直接导致程序崩溃，但如果忽略的话，可能在某些复杂SVG场景下引发解析异常或渲染问题，所以建议尽早处理。

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