Java XmlRpc Server抛出NoSuchMethodError：Encodings.isRecognizedEncoding方法缺失求助

我之前也碰到过类似的类加载冲突坑，你的情况核心是：虽然你确认类路径里有带isRecognizedEncoding方法的Encodings.class，但JVM实际加载的是另一个缺少该方法的版本，导致抛出NoSuchMethodError。下面是具体的排查和解决步骤：

1. 排查类路径中的冲突jar包 #

容器里很可能存在多个包含org.apache.xml.serializer.Encodings类的jar，比如旧版本的xalan.jar、xml-apis.jar，它们的Encodings类没有这个方法。

执行以下命令找出所有可疑jar：

# 遍历容器内所有jar，找出包含Encodings类的文件
find / -name "*.jar" 2>/dev/null | xargs grep -l "org/apache/xml/serializer/Encodings.class"

对每个找到的jar，验证是否包含目标方法：

# 替换<jar-file>为实际jar路径，检查是否有isRecognizedEncoding方法
javap -cp <jar-file> org.apache.xml.serializer.Encodings | grep isRecognizedEncoding

如果某个jar返回空，那它就是冲突源，需要移除或者调整加载顺序。

2. 调整类加载顺序 #

如果不能移除冲突jar，可以强制让xalan-j2-serializer.jar优先加载。修改你的容器启动命令，把它放在类路径的最前面：

# 示例：将xalan-j2-serializer.jar放在类路径首位
java -cp xalan-j2-serializer.jar:your-other-jars/* com.your.api.server.MainClass

3. 避免JDK自带xml类的干扰 #

OpenJDK 8自带的xml处理类可能和第三方xalan包冲突，你可以在启动JVM时添加参数，强制使用xalan的实现：

java -cp ... \
  -Djavax.xml.parsers.DocumentBuilderFactory=org.apache.xerces.jaxp.DocumentBuilderFactoryImpl \
  -Djavax.xml.transform.TransformerFactory=org.apache.xalan.xsltc.trax.TransformerFactoryImpl \
  com.your.api.server.MainClass

4. 验证jar版本匹配性 #

确保xalan-j2-serializer.jar和你使用的xalan核心jar（比如xalan.jar）版本完全一致，版本不匹配也会导致方法签名不兼容。你可以查看jar的MANIFEST文件确认版本：

jar xf xalan-j2-serializer.jar META-INF/MANIFEST.MF
cat META-INF/MANIFEST.MF | grep "Implementation-Version"

如果版本不匹配，下载官方同版本的序列化器jar替换即可。

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