Puppeteer使用XPath获取元素属性值报无效选择器错误如何解决

• 核心原因：Puppeteer的page.$eval()方法默认只接收CSS选择器作为定位参数，底层会调用原生DOM API document.querySelector()执行匹配，而该API不支持XPath语法。你传入的字符串包含//、text()、following::这类XPath专属语法，解析时会直接判定为无效选择器抛出错误。
• 额外的语法错误：
  1. 你写的XPath表达式末尾多了多余的空格和.，属于不符合规范的XPath写法
  2. 原生DOM获取元素属性的方法是getAttribute()，不存在复数形式的getAttributes()方法，即使定位成功也会触发方法不存在的报错

优先使用Puppeteer内置的XPath专属定位方法page.$x()实现，不需要改写原有XPath逻辑，代码如下：

// 修正原XPath末尾多余的空格和点
const xpathExpression = '//div[text()="5546800"]//following::div[@col-id="21"]'
// $x方法返回匹配到的所有元素组成的数组，无匹配时返回空数组
const [targetElement] = await page.$x(xpathExpression)

if (!targetElement) {
  throw new Error('定位目标元素失败，请检查XPath表达式或页面加载状态')
}

// 传入元素句柄，执行属性获取逻辑，注意修正getAttribute的拼写
const typeAttribute = await page.evaluate(el => el.getAttribute('type'), targetElement)

如果坚持使用page.$eval()，需要把XPath改写为等价的CSS选择器逻辑，但CSS选择器原生不支持文本匹配、后续轴（following）定位，需要手动在evaluate回调里写DOM遍历逻辑，实现繁琐易出错，不推荐使用。

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