在JMeter中处理XML响应时，XPath Extractor是常用的后置处理器。它基于XPath表达式对响应内容进行解析，把命中的节点值写入指定变量。只要响应是结构良好的XML或经过Tidy整理后的类XML文档，就能避免正则表达式在嵌套、换行和属性值上的匹配问题。下面直接介绍配置和表达式写法。
一、XPath Extractor 的基础配置
添加XPath Extractor后，首要关注Apply to作用域。默认Main sample only只处理主采样器响应；如果请求包含重定向或子请求，需要根据情况选择Main sample and sub-samples或Sub-samples only。然后填写Reference Name，这个值决定后续通过${变量名}引用提取结果。
核心配置是XPath Query。可以写绝对路径如/bookstore/book[1]/title/text()，也可以写相对路径//title/text()。Default Value建议保持非空，例如NOT_FOUND。当表达式没有命中节点时，JMeter不会删除变量，而是使用默认值，这样后续HTTP请求不会因为变量未定义而抛出异常。
解析选项中有两个开关影响较大。Use Tidy开启后，JMeter会借助Tidy把响应整理成更规范的XML，适合HTML混杂或标签不闭合的场景，但Tidy可能修改节点名称大小写，严格XML接口建议关闭。Use Namespaces用于带命名空间的XML，开启后XPath表达式需要按命名空间规则处理，否则容易提取为空。
| 参数 | 建议设置 | 说明 |
|---|---|---|
| Reference Name | 自定义变量名 | 后续用${变量名}引用 |
| XPath Query | 根据节点路径填写 | 支持绝对路径和相对路径 |
| Default Value | NOT_FOUND | 未匹配时返回默认值 |
| Use Tidy | 严格XML时关闭 | 开启后解析非严格XML |
| Return entire XPath fragment | 按需勾选 | 返回整个节点而非仅文本 |
二、常用XPath表达式与返回结果
以一个典型的图书列表XML响应为例，结构如下。
<bookstore>
<book category="fiction">
<title lang="en">Harry Potter</title>
<author>J K. Rowling</author>
<price>29.99</price>
</book>
<book category="web">
<title lang="zh">JMeter实战</title>
<author>测试团队</author>
<price>39.00</price>
</book>
</bookstore>
如果只需要第一本书的标题文本，表达式写成//book[1]/title/text()。注意索引从1开始，不是0。若要按属性过滤，使用//book[@category='web']/author/text()可以得到类别为web的作者。属性值匹配时单引号和双引号都可以，JMeter配置中建议使用单引号，避免与外部引号混淆。
当需要提取节点属性值，例如标题的语言编码，使用//book[1]/title/@lang。该表达式返回en，不会包含属性名。若需要整个节点XML片段，例如把第一本书节点传入下一个请求做二次处理，可以勾选Return entire XPath fragment instead of text content?，XPath Query写//book[1]，不追加text()。此时变量值是一个XML字符串，后续可以通过DOM继续解析。
提取多个节点时，XPath Extractor默认只返回第一个匹配节点。若需要全部匹配值，可以改用XPath2 Extractor或多次添加提取器并指定不同变量名。对于简单场景，也可以使用//book/title/text()验证是否存在结果，但变量中只保留第一个节点文本。
三、命名空间响应与Tidy解析的注意点
SOAP接口返回的XML往往带默认命名空间或前缀。例如下面响应：
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<queryResponse xmlns="http://ipipp.com/service">
<result>success</result>
</queryResponse>
</soap:Body>
</soap:Envelope>
如果直接使用//queryResponse/result/text()或//soap:Body/queryResponse/result/text()，往往会提取失败。原因是命名空间前缀在XPath中需要预先绑定，而JMeter的XPath Extractor配置面板无法直接声明前缀映射。常见的解决办法是关闭Use Namespaces选项，再使用local-name()函数忽略命名空间前缀，例如//*[local-name()='result']/text()。这个表达式会匹配任意命名空间下名为result的节点。
如果结果中存在多个同名result节点，可以用更严格的路径缩小范围，如//*[local-name()='queryResponse']/*[local-name()='result']/text()。这种方法不用修改响应，也不需要额外引入脚本，适合大多数SOAP测试。若勾选了Use Namespaces，就需要在表达式里使用命名空间URI，但受限于JMeter的XPath实现，写法复杂且容易报错，因此更推荐关闭该选项。
Use Tidy在HTML响应中很有用，但对严格XML反而可能帮倒忙。例如Tidy会将某些节点名统一为小写，或自动补全缺失标签，使原本与响应结构一致的绝对路径失效。如果开启Tidy后提取结果始终为空，建议先关闭该选项，再用Debug Sampler查看原始响应，确认XML标签大小写和层级。
四、变量引用与调试建议
XPath Extractor运行后，结果保存在Reference Name指定的变量中。例如变量名为bookTitle，后续HTTP请求参数可以直接写${bookTitle}，在参数值、请求头或Body中都能引用。需要注意JMeter变量的作用域是当前线程内，如果跨线程组传递，需要结合BeanShell或JSR223脚本转为属性。
调试时优先添加Debug Sampler，它会把用户定义的变量和提取结果输出到查看结果树中。也可以使用JSR223 Assertion打印变量，但Debug Sampler更直观。断言时建议配合Response Assertion或XPath Assertion，对提取到的值做非空校验或内容匹配，避免因环境变化导致变量为空仍继续执行。
当表达式不确定时，可以先在线XML工具或浏览器开发者工具中验证XPath是否命中，再粘贴到JMeter。XPath Extractor不会显示表达式解析过程，所以缩小调试范围很重要。可以先用//*查看能否命中任意节点，再逐步增加路径层级，直到定位到目标元素。
JMeterXPath ExtractorXML响应提取修改时间：2026-09-28 01:19:07