在进行网页数据抓取时，尤其是针对google maps这类高度动态的网站，开发者常会遇到数据抓取不完整或失败的问题。其中一个典型场景是，尽管成功识别了多个列表项，但在尝试提取每个列表项的详细信息（如评论数量和平均分）时，却只能获取到部分数据。这通常源于对动态内容加载机制理解不足、选择器不够健壮以及页面交互时序处理不当。
Google Maps数据抓取挑战解析
Google Maps的页面内容是高度动态生成的，这意味着浏览器在加载初始HTML后，会通过JavaScript异步加载大量数据并渲染页面。这给传统的静态HTML解析带来了挑战，同时也引入了以下具体问题：
- 动态内容加载与时序问题： 当用户点击一个列表项时，Google Maps会异步加载该商家的详细信息面板。如果爬虫在详情面板完全加载并渲染之前就尝试获取数据，很可能会因为元素尚未出现而失败，或者获取到旧的、不完整的数据。简单地使用固定延时（如time.sleep()或page.wait_for_timeout())是不可靠的，因为网络状况、服务器响应速度等因素都会影响页面加载时间。
- 选择器脆弱性： 网页元素的选择器（XPath或CSS Selector）可能因页面结构更新而失效。尤其当选择器依赖于元素的绝对路径或列表中的索引时，这种脆弱性会更明显。例如，原始代码中reviews_span_xpath = f'//div[{index + 1}]//span[@role="img"]'的设计，试图在点击列表项后，仍然通过列表项的索引来定位详情页中的元素。然而，当详情面板弹出时，其内部元素的上下文已与原始列表项脱离，导致该选择器无法正确匹配。
- 页面交互上下文管理： 爬虫需要明确当前操作的上下文。点击列表项后，后续的数据抓取操作应针对新加载的详情面板，而不是继续在原始的列表视图中寻找元素。
提升抓取鲁棒性的核心策略
为了克服上述挑战，构建一个稳定高效的Google Maps爬虫，以下策略至关重要：
1. 智能等待机制：告别固定延时
替代不精确的page.wait_for_timeout()，应使用Playwright提供的智能等待方法，确保目标元素真正可见或可交互。
- page.wait_for_selector(selector, state='visible', timeout=...)： 这是最常用的智能等待方法。它会等待由selector指定的元素在页面上可见。你可以指定state为'attached'（元素存在于DOM中）、'visible'（元素可见）、'hidden'（元素不可见）或'detached'（元素从DOM中移除）。
- page.wait_for_load_state(state='networkidle', timeout=...)： 等待页面达到某个加载状态，例如'networkidle'（网络空闲，表示没有新的网络请求发出）。
示例： 在点击列表项后，应等待详情面板中的某个关键元素（如商家名称）加载完成，再进行后续的数据提取。
# 点击列表项 listings[index].click() # 等待详情面板中的商家名称元素出现，这是判断详情页加载完成的可靠标志 # 假设详情页的商家名称元素具有 'qBF1Pd fontHeadlineSmall' 类 detail_name_selector = 'div.qBF1Pd.fontHeadlineSmall' page.wait_for_selector(detail_name_selector, timeout=15000) # 最长等待15秒
2. 构建稳定选择器：避免索引依赖
选择器应尽可能地通用且不依赖于页面中元素的动态索引。优先使用：
- CSS选择器： 通常比XPath更简洁，性能更高。
- 基于属性的选择器： 例如[data-item-id="address"]、[aria-label*="stars"]。这些属性通常比类名或结构更稳定。
- 相对路径XPath： 当CSS选择器无法满足需求时，使用相对路径XPath（如//div[contains(@class, "someClass")]），避免使用绝对路径。
问题分析与修正： 原始代码中的reviews_span_xpath = f'//div[{index + 1}]//span[@role="img"]'是导致问题的主要原因。这个XPath尝试通过列表项的索引来定位评论元素，但在点击列表项后，页面上下文已经切换到详情面板，该索引不再适用。
修正思路： 评论信息（如星级和评论数）在详情面板中通常由一个具有特定role="img"和aria-label属性的span元素表示。我们应该在详情面板加载完成后，使用一个通用的选择器来定位这个元素。
# 详情页中评论元素的通用CSS选择器 # 查找 role="img" 且 aria-label 属性包含 "stars" 的 span 元素 DETAIL_REVIEWS_SPAN_SELECTOR = 'span[role="img
