无头Chrome下Selenium通过XPath定位WhatsApp Web元素失败求助

1. 修复无头模式窗口尺寸 #

无头Chrome默认窗口极小，会触发WhatsApp Web的响应式布局切换，导致元素结构或可见性异常。添加固定窗口大小参数：

options.add_argument('--window-size=1920,1080')

2. 复用已登录的Chrome用户数据目录 #

无头模式默认使用临时用户数据，每次启动都需重新扫码登录，页面停留在登录界面时自然找不到聊天元素。指定本地Chrome的用户数据目录（路径根据系统调整）：

# Mac示例路径，Windows一般为C:\Users\<用户名>\AppData\Local\Google\Chrome\User Data
options.add_argument(r'--user-data-dir=/Users/rajeevranjanpandey/Library/Application Support/Google/Chrome/Default')

注意：运行脚本前必须关闭所有本地Chrome窗口，否则会出现端口占用报错。

3. 替换过时定位方法并使用显式等待 #

代码中混合使用了已弃用的find_element_by_xpath，统一改用Selenium 4+的find_element(By.XPATH, ...)，同时用WebDriverWait替代固定time.sleep，确保元素完全加载：

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 等待聊天元素加载并可点击
wait = WebDriverWait(driver, 20)
chat_element = wait.until(EC.element_to_be_clickable((By.XPATH, "//div/span[@title='Bookmark']")))
chat_element.click()  # 原代码中给聊天元素send_keys是错误操作，直接点击即可

4. 添加无头模式兼容参数 #

避免WhatsApp Web检测到自动化环境，添加以下参数：

options.add_argument('--no-sandbox')
options.add_argument('--disable-dev-shm-usage')
options.add_argument('--disable-blink-features=AutomationControlled')
options.add_experimental_option('excludeSwitches', ['enable-automation'])
options.add_experimental_option('useAutomationExtension', False)

另外，Chrome 112+版本推荐使用--headless=new替代旧的--headless，渲染逻辑更接近正常Chrome。

修正后的完整代码 #

import time
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.chrome.service import Service
from webdriver_manager.chrome import ChromeDriverManager
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC

# 设置Chrome无头模式选项
options = webdriver.ChromeOptions()
options.add_argument('--headless=new')
options.add_argument('--window-size=1920,1080')
options.add_argument('--disable-gpu')
options.add_argument('--no-sandbox')
options.add_argument('--disable-dev-shm-usage')
options.add_argument('--disable-blink-features=AutomationControlled')
options.add_experimental_option('excludeSwitches', ['enable-automation'])
options.add_experimental_option('useAutomationExtension', False)
# 复用本地已登录的用户数据目录（替换为你的实际路径）
options.add_argument(r'--user-data-dir=/Users/rajeevranjanpandey/Library/Application Support/Google/Chrome/Default')

# 启动浏览器并访问WhatsApp Web
driver = webdriver.Chrome(service=Service(ChromeDriverManager().install()), options=options)
driver.get("https://web.whatsapp.com/")

# 等待页面加载完成
wait = WebDriverWait(driver, 30)

# 直接点击目标聊天项
chat_element = wait.until(EC.element_to_be_clickable((By.XPATH, "//div/span[@title='Bookmark']")))
chat_element.click()

# 等待聊天窗口打开
time.sleep(2)

# 点击附件按钮
attachment_box = wait.until(EC.element_to_be_clickable((By.XPATH, "//div[contains(@title, 'Attach')]")))
attachment_box.click()

# 上传图片
upload_button = wait.until(EC.presence_of_element_located((By.XPATH, "//input[@type='file']")))
upload_button.send_keys("/Users/rajeevranjanpandey/Desktop/Screenshot 2023-04-11 at 3.44.43 PM.png")

# 等待图片加载完成并点击发送
send_button = wait.until(EC.element_to_be_clickable((By.XPATH, "//span[@data-icon='send']")))
send_button.click()

# 等待发送完成后关闭浏览器
time.sleep(5)
driver.quit()

关键说明 #

• 原代码中search_box.send_keys(chat_name)是错误操作：定位的是聊天项元素而非搜索框，直接点击即可触发聊天窗口打开。
• 若目标聊天不在可见列表内，可改用搜索框定位（代码中已注释相关逻辑）。

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