XMLInputFactory.newInstance()抛FactoryConfigurationError的根本原因是JVM未找到合规StAX实现：Java 9+默认不可见JDK内部类，且第三方SPI配置常未加载；应检查classpath含具体实现jar（如Woodstox），避免依赖com.sun.*内部API。
为什么 XMLInputFactory.newInstance() 有时会抛 FactoryConfigurationError
根本原因不是代码写错了，而是 JVM 启动时没找到符合规范的 StAX 实现类。JDK 自带的 com.sun.xml.internal.stream.XMLInputFactoryImpl 在 Java 9+ 默认不可见，且很多第三方库（比如 Woodstox、Aalto）的 SPI 配置没被正确加载。
常见错误现象：javax.xml.stream.FactoryConfigurationError: Provider com.sun.xml.internal.stream.XMLInputFactoryImpl not found 或直接 fallback 到空实现导致解析失败。
- 检查 classpath 是否真有 StAX 实现 jar（如
woodstox-core-asl-4.4.1.jar），光有stax-api接口包不够 - Java 9+ 必须显式加
--add-modules java.xml.bind（仅限早期迁移），更稳妥的是用ServiceLoader.load(XMLInputFactory.class)替代静态工厂方法 - 避免依赖
com.sun.*内部类——它们不是公共 API，不同 JDK 版本路径可能变化甚至被移除
如何安全获取线程安全的 XMLInputFactory 实例
XMLInputFactory 本身是线程安全的，但它的实例不建议全局单例复用，因为部分实现（如 Woodstox）会在实例上缓存配置状态，多线程修改 setProperty() 可能互相干扰。
推荐做法是每个解析上下文创建独立实例，并统一配置关键参数：
- 设
factory.setProperty(，否则默认不识别命名空间javax.xml.stream.isNamespaceAware, Boolean.TRUE) - 禁用 DTD（防止 XXE）：
factory.setProperty(javax.xml.stream.isSupportingExternalEntities, Boolean.FALSE) - 若需读取注释，必须提前设
factory.setProperty(，否则javax.xml.stream.isCoalescing, Boolean.TRUE)nextTag()可能跳过注释
对比 newInstance() 和 newFactory() 的行为差异
JDK 6 引入了 XMLInputFactory.newFactory()，它比 newInstance() 更严格：前者只走标准 SPI 查找（META-INF/services/javax.xml.stream.XMLInputFactory），后者还会尝试硬编码 fallback 到 Sun 内部实现。
这意味着：
- 用
newFactory()能更快暴露缺失实现的问题，适合构建环境验证 - 在 Android 或某些精简 JRE 上，
newInstance()可能静默返回一个功能受限的空实现，而newFactory()直接抛异常 - 两者都支持传入
ClassLoader参数，但只有显式传入非null的 classloader 才能绕过模块系统限制（Java 9+）
Woodstox 下 XMLInputFactory 的典型初始化陷阱
Woodstox 是最常用的高性能 StAX 实现，但它不兼容 JDK 自带工厂的某些默认行为。比如默认关闭 CDATA 事件，或对空白字符处理更严格。
容易踩的坑：
- 没调用
WoodstoxInputFactory.setProperty(就想做 XSD 校验 → 直接忽略校验逻辑org.codehaus.stax2.validation.XMLValidationSchema, schema) - 用
XMLInputFactory.newInstance()获取到的是 JDK 默认实现，不是 Woodstox —— 必须确保woodstox-core-asl在 classpath 且META-INF/services/...文件存在 - 设置
javax.xml.stream.isReplacingEntityReferences为false后，仍看到实体被展开 → Woodstox 默认忽略该属性，得用org.codehaus.stax2.typed.TypedXMLStreamReader手动控制
JDK 版本和类加载器策略是影响 XMLInputFactory.newInstance() 行为最隐蔽的两个变量，调试时优先检查这两点，而不是怀疑 XML 内容本身。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
