WebdriverIO如何配置驱动程序的自定义npm仓库？

问题根源 #

WebdriverIO 默认通过 chromedriver 包或内置的驱动管理工具直接从官方CDN拉取二进制驱动文件，这套逻辑不读取你 .npmrc 里的私有源配置，所以哪怕项目所有npm依赖都走内网仓库，驱动还是会硬连外网请求。

直接配置驱动源的方法 #

1. 用环境变量指定驱动镜像源 #

如果你项目里依赖了 chromedriver 包，可以通过环境变量强制它从私有源拉取：

• 临时生效：在终端执行

  export CHROMEDRIVER_CDNURL=http://你的私有仓库地址/chromedriver/
  

• 永久生效：把这个变量加到项目的 .env 文件，或者公司统一的环境变量配置中。

其他驱动对应环境变量：

• Geckodriver: GECKODRIVER_CDNURL
• Edgedriver: EDGEDRIVER_CDNURL

2. 直接指定本地驱动路径 #

如果用的是 @wdio/chromedriver-service 服务，可以在 wdio.conf.js 里直接指定已下载好的本地驱动路径，跳过自动下载：

// wdio.conf.js
exports.config = {
  // ...其他配置项
  services: [
    ['chromedriver', {
      chromedriverCustomPath: './drivers/chromedriver' // 你的本地驱动路径
    }]
  ]
}

这种方式需要先手动从私有仓库把对应版本的驱动下载到项目目录中。

离线预下载的替代方案 #

如果环境变量配置不生效，或者需要批量管理驱动版本，可以这么操作：

1. 在外网环境下载好对应系统、对应版本的驱动二进制文件（比如chromedriver v118.0.5993.70）。
2. 把这些文件上传到公司内部的私有仓库或文件服务器。
3. 在项目的 package.json 里添加预安装脚本，自动从私有源拉取驱动：

   {
     "scripts": {
       "preinstall": "curl http://你的私有仓库地址/chromedriver/linux/chromedriver-v118.0.5993.70 > ./drivers/chromedriver && chmod +x ./drivers/chromedriver"
     }
   }
   

4. 然后在 wdio.conf.js 里指定这个本地路径即可。

关键注意点 #

• 必须保证私有仓库里的驱动版本和项目依赖的 chromedriver 包版本完全一致，否则会出现兼容性问题。
• Windows系统下，驱动文件后缀为 .exe，脚本里要对应调整路径和命令。

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