无法替换节点值：SOAP字符串转Document后XPath无法定位节点

嘿，我之前也踩过这个坑！你的问题核心是SOAP XML的命名空间没被正确处理，加上可能转换字符串到Document时的两个小疏忽，才导致XPath定位节点返回null。咱们一步步来解决：

问题根源拆解 #

你的SOAP字符串里所有节点都带soap:前缀，对应的命名空间URI是http://www.w3.org/2003/05/soap-envelope。但默认的XPath查询不会自动关联前缀和URI，而且如果你的convertStringToDocument方法没做两个关键配置，Document对象里的节点结构会完全不符合预期：

1. 没开启命名空间感知：Document会把soap:当成节点名的一部分，而不是命名空间前缀
2. 没还原转义字符：原始字符串里的</>没转成</>，导致整个内容变成文本节点，而非XML元素

解决方案 #

第一步：修复convertStringToDocument方法

必须开启命名空间感知，同时还原XML转义字符：

private static Document convertStringToDocument(String xmlStr) throws ParserConfigurationException, IOException, SAXException {
    DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
    // 重中之重：开启命名空间感知，否则Document不会保留命名空间信息
    factory.setNamespaceAware(true);
    DocumentBuilder builder = factory.newDocumentBuilder();
    // 把转义的<>还原成真实的XML标签
    String unescapedXml = org.apache.commons.text.StringEscapeUtils.unescapeXml(xmlStr);
    return builder.parse(new InputSource(new StringReader(unescapedXml)));
}

（如果没引入Apache Commons Text，也可以手动替换<为<、>为>，但工具类更稳妥）

第二步：给XPath绑定命名空间

现在Document里的节点已经正确携带命名空间了，接下来要让XPath知道soap:前缀对应的URI：

// 转换字符串到Document
Document doc = convertStringToDocument(testMsg);
XPath xpath = XPathFactory.newInstance().newXPath();

// 绑定SOAP命名空间
xpath.setNamespaceContext(new NamespaceContext() {
    @Override
    public String getNamespaceURI(String prefix) {
        if ("soap".equals(prefix)) {
            return "http://www.w3.org/2003/05/soap-envelope";
        }
        return XMLConstants.NULL_NS_URI;
    }

    @Override
    public String getPrefix(String namespaceURI) {
        if ("http://www.w3.org/2003/05/soap-envelope".equals(namespaceURI)) {
            return "soap";
        }
        return null;
    }

    @Override
    public Iterator<String> getPrefixes(String namespaceURI) {
        return Collections.singletonList("soap").iterator();
    }
});

// 现在就能正常定位节点并设置文本了！
Node bodyNode = (Node) xpath.evaluate("/soap:Envelope/soap:Body", doc, XPathConstants.NODE);
if (bodyNode != null) {
    bodyNode.setTextContent("Updated Body Content Here");
}

额外小提示 #

如果你不想写自定义的NamespaceContext，也可以用Java 8+的简化写法，或者引入第三方库（比如JDOM2）来简化XPath查询，但上面的方案是最原生、不需要额外依赖的。

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