Selenium打开空白页如何全局重试？多环境框架适配咨询

针对低配置环境下Selenium页面加载空白的问题，推荐两种无需侵入原有页面打开逻辑的全局重试方案，同时给出重试策略的建议：

方案1：利用Selenium事件监听机制 #

通过注册导航事件监听器，在每次页面导航完成后自动检查页面状态，若加载失败则触发重试逻辑，完全不影响原有业务代码。

核心思路 #

重写afterNavigateTo方法，在页面导航后执行页面健康检查：

• 检查document.readyState是否为complete
• 检查页面核心内容（如body是否为空、关键元素是否存在）
• 若异常则先尝试刷新，仍失败则重新发起导航，最多重试N次

Python代码示例

from selenium import webdriver
from selenium.webdriver.support.events import EventFiringWebDriver, AbstractEventListener
import time

class RetryNavigationListener(AbstractEventListener):
    def __init__(self, max_retries=2, wait_time=8):
        self.max_retries = max_retries
        self.wait_time = wait_time

    def after_navigate_to(self, url, driver):
        self._check_and_retry(url, driver)

    def _check_and_retry(self, url, driver):
        retry_count = 0
        while retry_count < self.max_retries:
            try:
                # 页面状态检查逻辑
                ready_state = driver.execute_script("return document.readyState")
                has_core_element = driver.execute_script("return document.querySelector('#main-content') !== null")
                
                if ready_state == "complete" and has_core_element:
                    break
                
                # 优先尝试刷新页面
                driver.refresh()
                time.sleep(self.wait_time)
                retry_count += 1
            except Exception:
                # 刷新失败则重新导航
                driver.get(url)
                time.sleep(self.wait_time)
                retry_count += 1

# 使用方式：替换原有WebDriver实例
original_driver = webdriver.Chrome()
driver = EventFiringWebDriver(original_driver, RetryNavigationListener())
# 后续所有页面打开操作都会自动触发重试逻辑
driver.get("https://target-page.com")

Java代码示例

import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.support.events.EventFiringWebDriver;
import org.openqa.selenium.support.events.WebDriverEventListener;

public class RetryNavigationListener implements WebDriverEventListener {
    private int maxRetries = 2;
    private long waitTime = 8000;

    @Override
    public void afterNavigateTo(String url, WebDriver driver) {
        checkAndRetry(url, driver);
    }

    private void checkAndRetry(String url, WebDriver driver) {
        int retryCount = 0;
        while (retryCount < maxRetries) {
            try {
                String readyState = (String) ((JavascriptExecutor) driver).executeScript("return document.readyState");
                boolean hasCoreElement = (boolean) ((JavascriptExecutor) driver).executeScript("return document.querySelector('#main-content') !== null");
                
                if ("complete".equals(readyState) && hasCoreElement) {
                    break;
                }
                
                driver.navigate().refresh();
                Thread.sleep(waitTime);
                retryCount++;
            } catch (InterruptedException e) {
                Thread.currentThread().interrupt();
                break;
            } catch (Exception e) {
                driver.get(url);
                Thread.sleep(waitTime);
                retryCount++;
            }
        }
    }

    // 其他未使用的接口方法空实现
    @Override public void beforeNavigateTo(String url, WebDriver driver) {}
    @Override public void beforeNavigateBack(WebDriver driver) {}
    @Override public void afterNavigateBack(WebDriver driver) {}
    @Override public void beforeNavigateForward(WebDriver driver) {}
    @Override public void afterNavigateForward(WebDriver driver) {}
    @Override public void beforeNavigateRefresh(WebDriver driver) {}
    @Override public void afterNavigateRefresh(WebDriver driver) {}
    @Override public void beforeFindBy(org.openqa.selenium.By by, org.openqa.selenium.WebElement element, WebDriver driver) {}
    @Override public void afterFindBy(org.openqa.selenium.By by, org.openqa.selenium.WebElement element, WebDriver driver) {}
    @Override public void beforeClickOn(org.openqa.selenium.WebElement element, WebDriver driver) {}
    @Override public void afterClickOn(org.openqa.selenium.WebElement element, WebDriver driver) {}
    @Override public void beforeChangeValueOf(org.openqa.selenium.WebElement element, WebDriver driver, CharSequence[] keysToSend) {}
    @Override public void afterChangeValueOf(org.openqa.selenium.WebElement element, WebDriver driver, CharSequence[] keysToSend) {}
    @Override public void beforeScript(String script, WebDriver driver) {}
    @Override public void afterScript(String script, WebDriver driver) {}
    @Override public void onException(Throwable throwable, WebDriver driver) {}
}

// 使用方式
WebDriver originalDriver = new ChromeDriver();
EventFiringWebDriver driver = new EventFiringWebDriver(originalDriver);
driver.register(new RetryNavigationListener());
driver.get("https://target-page.com");

方案2：WebDriver代理模式 #

通过包装原生WebDriver类，重写get、navigate().to等导航方法，在方法内部嵌入重试逻辑，原有代码只需替换WebDriver实例即可生效。

Java代码示例（核心部分） #

import org.openqa.selenium.JavascriptExecutor;
import org.openqa.selenium.Navigation;
import org.openqa.selenium.remote.RemoteWebDriver;

public class RetryWebDriver extends RemoteWebDriver {
    private int maxRetries = 2;
    private long waitTime = 8000;

    public RetryWebDriver(RemoteWebDriver delegate) {
        super(delegate.getCommandExecutor(), delegate.getCapabilities());
    }

    @Override
    public void get(String url) {
        int retryCount = 0;
        while (retryCount < maxRetries) {
            super.get(url);
            try {
                Thread.sleep(waitTime);
                String readyState = (String) executeScript("return document.readyState");
                boolean hasCoreElement = (boolean) executeScript("return document.querySelector('#main-content') !== null");
                
                if ("complete".equals(readyState) && hasCoreElement) {
                    return;
                }
                
                navigate().refresh();
                Thread.sleep(waitTime);
                retryCount++;
            } catch (InterruptedException e) {
                Thread.currentThread().interrupt();
                return;
            }
        }
    }

    // 重写navigate方法，统一处理导航逻辑
    @Override
    public Navigation navigate() {
        return new Navigation() {
            private Navigation delegate = RetryWebDriver.super.navigate();

            @Override
            public void to(String url) {
                RetryWebDriver.this.get(url);
            }

            @Override
            public void to(java.net.URL url) {
                to(url.toString());
            }

            @Override public void back() { delegate.back(); }
            @Override public void forward() { delegate.forward(); }
            @Override public void refresh() { delegate.refresh(); }
        };
    }
}

// 使用方式
RemoteWebDriver originalDriver = new ChromeDriver();
WebDriver driver = new RetryWebDriver(originalDriver);
driver.get("https://target-page.com");

关于重试策略：优先刷新还是重新导航？ #

推荐先刷新，再重新导航的顺序：

1. 刷新是更轻量的操作，无需重新建立网络连接，在低配置环境下成功率更高，耗时更短
2. 若刷新2次后仍加载失败，再重新发起导航请求，避免无效刷新浪费时间
3. 可根据环境调整重试次数和等待时间（低配置环境建议等待8-10秒，重试2-3次）

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