如何解决LaravelDuskChromeDriver版本不匹配问题，staudenmeir/dusk-updater助你轻松搞定自动化测试环境

最近在进行一个 Laravel 项目的开发时，我发现自动化测试的重要性日益凸显。特别是涉及到前端交互的测试，Laravel Dusk 提供了强大的能力。然而，Dusk 在实际使用中有一个常见痛点：ChromeDriver 的版本管理。

composer在线学习地址：学习地址

我的困境是这样的：Dusk 依赖于 ChromeDriver 来驱动真实的 Chrome 或 Chromium 浏览器执行测试。但 Chrome 浏览器更新频率很快，每次更新都可能导致现有的 ChromeDriver 无法正常工作，报错提示版本不匹配。这意味着我需要：

1. 手动检查当前 Chrome 浏览器的版本。
2. 访问 ChromeDriver 官方网站，找到对应版本的 ChromeDriver。
3. 下载正确的二进制文件。
4. 将其替换到项目的正确位置（通常是

   vendor/laravel/dusk/bin

   目录下）。

这个过程在本地开发时就已经很繁琐了，更不用说在团队协作和 CI/CD 环境中。每次环境部署或浏览器更新，都可能需要重复这些步骤，极大地降低了开发效率和测试的可靠性。有时候，Dusk 测试失败，排查半天发现竟然是 ChromeDriver 版本的问题，而不是代码本身，这简直让人抓狂！

staudenmeir/dusk-updater

：我的救星来了！

就在我被这个问题折磨得不轻时，我发现了

staudenmeir/dusk-updater

安装过程非常简单：

因为它只在开发和测试环境中使用，所以我们将其作为开发依赖安装：

composer require --dev staudenmeir/dusk-updater:"^1.1"

如果你使用的是 Laravel 5.4 版本，还需要在

AppServiceProvider::register()

// app/Providers/AppServiceProvider.php

if ($this->app->environment('local', 'testing')) {
    $this->app->register(\Staudenmeir\DuskUpdater\DuskServiceProvider::class);
}

对于更高版本的 Laravel，通常会自动发现并注册。

奇布塔

基于AI生成技术的一站式有声绘本创作平台

下载

使用起来更是方便快捷：

安装完成后，你就可以使用 Artisan 命令来管理 ChromeDriver 了。

1. 下载最新的稳定版 ChromeDriver： 这是最基本的用法，它会下载与最新稳定版 Chrome 兼容的 ChromeDriver。

   php artisan dusk:update

2. 自动检测已安装的 Chrome/Chromium 版本并更新： 这是我最常用的功能，也是这个包的核心优势所在。它会智能地检测你系统上安装的 Chrome/Chromium 浏览器版本，并下载与之完全匹配的 ChromeDriver。

   php artisan dusk:update --detect

   这样一来，无论你的浏览器何时更新，只需运行这个命令，就能保证 ChromeDriver 始终与浏览器版本同步。

3. 手动指定 Chrome/Chromium 的主版本号： 如果你想针对某个特定版本的 Chrome 浏览器进行测试，可以手动指定其主版本号。

   php artisan dusk:update 127

4. 手动指定精确的 ChromeDriver 版本： 在某些特定情况下，你可能需要使用某个精确版本的 ChromeDriver。

   php artisan dusk:update 127.0.6533.119

实际应用效果和优势：

自从我引入

staudenmeir/dusk-updater

• 告别手动更新的烦恼：再也不用花费时间去查找和下载 ChromeDriver 了，大大节省了开发时间。
• 提升测试可靠性：确保了 ChromeDriver 与浏览器版本始终匹配，避免了因版本不兼容导致的测试失败，让测试结果更加准确可信。
• 简化团队协作：团队成员无需各自维护 ChromeDriver 版本，只需执行

  composer install

  后运行

  php artisan dusk:update --detect

  ，就能快速搭建起一致的测试环境。
• 优化 CI/CD 流程：在 CI/CD 脚本中加入

  php artisan dusk:update --detect

  命令，可以自动化 ChromeDriver 的更新，确保每次部署的自动化测试都能顺利运行，极大地提高了集成和部署效率。
• “一劳永逸”的解决方案：一旦配置好，几乎可以“忘记”ChromeDriver 的版本管理问题，将精力更多地投入到业务逻辑的开发和测试上。

总结：

对于任何使用 Laravel Dusk 进行自动化测试的开发者来说，

staudenmeir/dusk-updater