Python Selenium循环异常：仅首次执行，后续报window_handles索引越界错误

使用Python+Selenium编写社交平台批量发消息脚本时，首次循环正常，但第二次循环会跳过打开新标签页的操作，直接执行driver.switch_to.window(driver.window_handles[1])，抛出索引越界错误。

脚本预期流程：

• 打开粉丝列表页面，滚动显示前12位粉丝；
• 循环定位第n位粉丝，Ctrl+点击打开个人主页新标签页；
• 切换到新标签页，点击发消息图标并发送消息；
• 关闭新标签页，切回粉丝列表页面进入下一次循环。

已确认粉丝定位XPath正确，使用Chrome浏览器，相关代码如下：

# 1. scroll down so that all 12 followers are shown
driver.execute_script("window.scrollTo(0, 450)")
for n in range(1, 13):
    # 2. find the user to send message and open in to new tab
    find_user = '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/main/div/div/div/div/div[3]/div/div[2]/div/div/div[2]/div[{}]/div/div/div[1]/div/span/a/div/p'.format(
        n)
    user_to_click = driver.find_element(By.XPATH, find_user)
    ActionChains(driver) \
        .key_down(Keys.CONTROL) \
        .click(user_to_click) \
        .key_up(Keys.CONTROL) \
        .perform()
    
    # load the message
    for idxi, message in enumerate(messages):
        new_message = message["message_to_post"]

    sleep(2)
    # 3. switch to TAB where the user that need to post is open
    driver.switch_to.window(driver.window_handles[1])
    
    # 4. wait for the post icon to show and click it
    driver.implicitly_wait(20)
    if fourth_button():
        driver.find_element(By.XPATH,
                            '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/main/div/div/div/div/div[1]/div[2]/div/div[2]/div/button[2]').click()
    else:
        driver.find_element(By.XPATH,
                            '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/main/div/div/div/div/div[1]/div[2]/div/div[2]/div/button[1]').click()

    # wait for the profile pic to be shown in the messenger, which is an indicator that the message can be send
    driver.implicitly_wait(30)
    try:
        driver.find_element(By.XPATH,
                            '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/div[2]/div/div/div[2]/div/div[2]/div/div[1]/div/div/div/div/div[1]/div/div[1]/a/div/img')
    except NoSuchElementException:
        pass

    # once the profile pic is loaded it paste the message in the send message field
    try:
        driver.find_element(By.XPATH,
                            '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/div[2]/div/div/div[2]/div/div[2]/div/div[2]/div[2]/div[2]/div/div/div/textarea').send_keys(
            new_message)
    except NoSuchElementException:
        pass
    # click on the send message button and send the message
    driver.implicitly_wait(5)
    try:
        driver.find_element(By.XPATH,
                            '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/div[2]/div/div/div[2]/div/div[2]/div/div[2]/div[2]/div[3]/button').click()
    except NoSuchElementException:
        pass

    sleep(3)
    # close the current tab
    driver.close()
    
    # switch to the first main tab where all the profiles are loaded
    driver.switch_to.window(driver.window_handles[0])
    sleep(2)

问题根源分析 #

• Ctrl+点击未生效：第二次循环时页面焦点偏移，或元素状态变化导致ActionChains的组合按键操作未触发新标签页打开；
• 硬编码索引不安全：直接使用driver.window_handles[1]假设新标签页始终是第二个，若新标签未打开则直接索引越界；
• 等待逻辑混乱：隐式等待与强制睡眠混用，全局生效的隐式等待会被后续设置覆盖，导致元素加载不充分时操作失败；
• 消息获取逻辑错误：每次循环遍历所有消息，最终new_message只会是最后一条，不符合批量发送不同消息的预期。

修复方案及优化代码 #

核心修改点 #

1. 改用CONTROL+RETURN打开新标签，比ActionChains更稳定；
2. 记录原标签页句柄，通过对比获取新标签，避免硬编码索引；
3. 替换隐式等待为显式等待，精准控制每个元素的加载等待；
4. 按循环索引对应消息列表，确保每条消息匹配对应粉丝。

修改后的代码 #

from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
from selenium.common.exceptions import TimeoutException

# 1. 滚动显示前12位粉丝，用显式等待确保滚动完成
driver.execute_script("window.scrollTo(0, 450)")
WebDriverWait(driver, 10).until(lambda d: driver.execute_script("return document.documentElement.scrollTop >= 450"))

# 确保消息数量足够（需循环使用消息可添加取余逻辑）
assert len(messages) >= 12, "消息数量不足12条"

for n in range(1, 13):
    # 2. 定位粉丝链接并打开新标签
    find_user = '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/main/div/div/div/div/div[3]/div/div[2]/div/div/div[2]/div[{}]/div/div/div[1]/div/span/a'.format(n)
    user_link = WebDriverWait(driver, 15).until(EC.element_to_be_clickable((By.XPATH, find_user)))
    
    # 用CONTROL+RETURN打开新标签，避免ActionChains的焦点问题
    user_link.send_keys(Keys.CONTROL + Keys.RETURN)
    
    # 等待新标签页出现并获取句柄
    original_windows = driver.window_handles
    WebDriverWait(driver, 10).until(lambda d: len(d.window_handles) > len(original_windows))
    new_window = [w for w in driver.window_handles if w not in original_windows][0]
    driver.switch_to.window(new_window)
    
    # 3. 等待并点击发消息按钮
    try:
        if fourth_button():
            message_btn = WebDriverWait(driver, 20).until(EC.element_to_be_clickable((By.XPATH, '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/main/div/div/div/div/div[1]/div[2]/div/div[2]/div/button[2]')))
        else:
            message_btn = WebDriverWait(driver, 20).until(EC.element_to_be_clickable((By.XPATH, '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/main/div/div/div/div/div[1]/div[2]/div/div[2]/div/button[1]')))
        message_btn.click()
    except TimeoutException:
        print(f"第{n}位用户的发消息按钮加载超时")
        driver.close()
        driver.switch_to.window(original_windows[0])
        continue
    
    # 4. 等待聊天窗口加载完成
    try:
        WebDriverWait(driver, 30).until(EC.visibility_of_element_located((By.XPATH, '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/div[2]/div/div/div[2]/div/div[2]/div/div[1]/div/div/div/div/div[1]/div/div[1]/a/div/img')))
    except TimeoutException:
        print(f"第{n}位用户的聊天窗口加载超时")
        driver.close()
        driver.switch_to.window(original_windows[0])
        continue
    
    # 5. 发送对应消息
    new_message = messages[n-1]["message_to_post"]
    try:
        message_input = WebDriverWait(driver, 15).until(EC.element_to_be_clickable((By.XPATH, '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/div[2]/div/div/div[2]/div/div[2]/div/div[2]/div[2]/div[2]/div/div/div/textarea')))
        message_input.send_keys(new_message)
        
        send_btn = WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.XPATH, '//*[@id="soapbox"]/div[1]/div/div[3]/div[1]/div/div[2]/div/div/div[2]/div/div[2]/div/div[2]/div[2]/div[3]/button')))
        send_btn.click()
    except TimeoutException:
        print(f"第{n}位用户消息发送失败")
    
    # 6. 关闭新标签并切回粉丝列表
    driver.close()
    driver.switch_to.window(original_windows[0])
    # 等待页面恢复可操作状态
    WebDriverWait(driver, 10).until(EC.element_to_be_clickable((By.XPATH, find_user)))

额外优化建议 #

• 替换绝对XPath为相对XPath或CSS选择器，降低页面结构变化的影响；
• 添加异常重试逻辑，提升脚本稳定性；
• 控制循环间隔，避免触发平台反爬机制；
• 为fourth_button()添加日志输出，验证其返回值是否符合预期。

内容的提问来源于stack exchange，提问作者blagoj-357