iText7加载许可证JSON文件失败：根级别数据无效问题求助

问题分析 #

从错误堆栈能看到，iText.License.Util.XmlWorker正在解析你的许可证文件，这说明当前调用的LicenseKey.LoadLicenseFile方法默认期望加载XML格式的许可证，但你传入的是JSON格式文件，导致XML解析器抛出"根级数据无效"的错误。

解决方案 #

• 确认版本与许可证格式兼容性：iText 7.1.16及之后版本才正式支持JSON许可证。如果你的iText版本低于此，要么升级到兼容版本，要么更换为XML格式的许可证文件。
• 调用正确的JSON加载方法：若版本支持JSON许可证，使用专门的JSON加载方法替代通用的LoadLicenseFile：

// 加载JSON格式许可证
LicenseKey.LoadLicenseFileFromJson(new FileStream(@"pathtofile\iTextKey.json", FileMode.Open));

• 验证文件实际格式：即使文件后缀是.json，也可能存在命名错误（实际是XML内容）。打开文件检查：
  • JSON格式以{开头、}结尾
  • XML格式以<?xml或<license>开头
    如果实际是XML，将后缀改为.xml，保持原有LoadLicenseFile调用即可。
• 检查文件编码BOM：若JSON文件内容无误，可能是文件包含UTF-8 BOM（字节顺序标记）导致解析异常。用文本编辑器（如Notepad++）将文件转换为无BOM的UTF-8编码后重试。

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