Playwright无法定位含非英文字符的文本元素问题排查

尝试点击文本为“São Vicente”的a标签，对应的HTML结构如下：

<li>
<a href="/comprar-casas/braga/sao-vicente/mapa">São Vicente</a>
<span class="subdued">139</span>
</li>

使用以下代码定位并点击：

zone = "São Vicente"

try: 
        tiredAF = page.locator('a:has-text("' + zone + '")')
        tiredAF.click()

但Playwright无法完成点击，错误日志如下：

=========================== logs ===========================
waiting for get_by_text("Vicente").first
  locator resolved to <a href="/comprar-casas/braga/sao-vicente/mapa">São Vicente</a>
attempting click action
  waiting for element to be visible, enabled and stable
    element is not visible - waiting...
============================================================

已添加time.sleep(10)确保页面加载完成，问题仍未解决，目标页面地址：https://www.idealista.pt/comprar-casas/braga/braga/braga/mapa

核心问题 #

从日志能看到，Playwright已经成功定位到目标元素，但元素处于不可见状态，导致点击动作无法执行。常见原因包括元素在视口外、被其他元素（如Cookie弹窗、侧边栏）遮挡，或者页面动态渲染后元素未自动滚动到可见区域。

解决方法 #

• 强制点击（跳过可见性检查）
  如果确认定位的元素就是目标，可以使用force=True参数强制点击，绕过可见性校验：

  tiredAF.click(force=True)
  

• 先滚动到元素可见区域再点击
  调用scroll_into_view_if_needed()方法让元素滚动到视口内，再执行点击：

  tiredAF.scroll_into_view_if_needed()
  tiredAF.click()
  

• 检查并关闭页面遮挡元素
  页面可能存在Cookie授权弹窗、侧边导航等遮挡元素，需要先处理这些弹窗再点击目标元素。例如先关闭Cookie弹窗（选择器需根据实际页面调整）：

  page.locator('button:has-text("Aceitar todos")').click()
  

• 使用更精准的定位器
  结合元素的href属性定位，避免文本匹配可能带来的编码或歧义问题：

  tiredAF = page.locator('a[href="/comprar-casas/braga/sao-vicente/mapa"]')
  tiredAF.click()
  

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