本地开发React站点，离线时WebdriverIO测试失败，如何解决？

看你的报错信息，问题明显出在WebdriverIO的onPrepare钩子阶段——断网时它没法从GitHub下载浏览器驱动（比如Geckodriver这类依赖），导致测试启动直接卡壳。下面给你几个实用的解决思路：

1. 预下载驱动到本地，配置WebdriverIO用本地文件 #

WebdriverIO默认会自动从官方源拉取驱动，但断网这步就废了。你可以手动把需要的驱动（比如Chromedriver、Geckodriver）下载到本地目录，然后在wdio.conf.js里指定本地路径，跳过自动下载：

// wdio.conf.js
exports.config = {
    // ...其他配置项
    services: [
        ['selenium-standalone', {
            drivers: {
                chrome: {
                    version: '114.0.5735.90', // 替换成你项目适配的版本
                    arch: process.arch,
                    baseURL: 'file:///Users/yourname/local-drivers/' // 本地驱动存放目录的文件URL
                },
                firefox: {
                    version: '0.33.0',
                    arch: process.arch,
                    baseURL: 'file:///Users/yourname/local-drivers/'
                }
            }
        }]
    ]
};

这样配置后，WebdriverIO会直接读取你本地的驱动文件，完全不用联网。

2. 禁用自动驱动管理，手动启动本地服务 #

如果你的开发环境已经有本地运行的Selenium Server或者单独的浏览器驱动服务，可以直接关掉WebdriverIO的自动驱动下载逻辑：

// wdio.conf.js
exports.config = {
    // ...其他配置项
    services: [], // 清空默认的selenium-standalone服务
    seleniumAddress: 'http://localhost:4444/wd/hub', // 指向你本地启动的Selenium服务地址
    // 或者直接指定本地驱动路径（以Chrome为例）
    capabilities: [{
        browserName: 'chrome',
        'goog:chromeOptions': {
            args: ['--headless', '--no-sandbox']
        },
        executablePath: '/Users/yourname/local-drivers/chromedriver'
    }]
};

之后你需要手动启动本地的驱动服务或Selenium Server，再运行gulp测试命令就行。

3. 检查onPrepare里的自定义联网逻辑 #

有时候项目会在onPrepare钩子中加一些联网操作（比如拉取远程测试数据、同步配置），你可以检查下wdio.conf.js里的这个函数，把依赖网络的逻辑改成离线可用的版本，或者在断网时跳过：

// wdio.conf.js
exports.config = {
    // ...其他配置项
    onPrepare: async function (config, capabilities) {
        // 简单实现一个网络检测逻辑（比如ping本地网关）
        const isOnline = await checkIfOnline(); 
        if (isOnline) {
            // 原来的联网操作
            await fetchRemoteTestData();
        } else {
            // 离线模式下用本地缓存的数据
            loadCachedTestData();
        }
    }
};

4. 用内网镜像源（如果有条件的话） #

如果你的开发环境有内网的GitHub镜像或者驱动镜像，可以把WebdriverIO的下载源换成内网地址，这样即使断外网，连内网也能正常获取驱动：

// wdio.conf.js
exports.config = {
    // ...其他配置项
    services: [
        ['selenium-standalone', {
            drivers: {
                chrome: {
                    baseURL: 'https://your-internal-mirror.com/chromedriver'
                },
                firefox: {
                    baseURL: 'https://your-internal-mirror.com/geckodriver'
                }
            }
        }]
    ]
};

内容的提问来源于stack exchange，提问作者Alan P.