Laravel Dusk 浏览器测试在MacOS M3 Pro上的兼容性问题解析

问题背景

在使用Laravel Dusk进行浏览器自动化测试时，开发者可能会遇到测试无法完成、进程挂起的问题。特别是在MacOS Sonoma 14.2.1系统搭配M3 Pro芯片的环境下，这种情况更为常见。本文将深入分析这一问题的根源及解决方案。

核心问题分析

问题的本质在于ChromeDriver版本与本地安装的Google Chrome浏览器版本不兼容。当开发者运行php artisan dusk命令时，测试无法正常完成，主要表现是：

1. 测试进程无响应或挂起
2. 偶尔显示测试错误标记(E)但无详细反馈
3. 测试套件无法完整执行

根本原因

经过技术分析，发现这是由于ChromeDriver版本与浏览器版本不匹配导致的。具体表现为：

• 系统安装的Google Chrome浏览器版本为120.0.6099.216
• 但Dusk安装的ChromeDriver版本为114.0.5735.90
• 这两个版本之间存在兼容性问题

解决方案

方法一：升级Laravel Dusk版本

较旧版本的Dusk(7.7.1)无法正确处理Chrome 115及以上版本的驱动管理。建议升级到7.9.0或更高版本：

composer require laravel/dusk --with-all-dependencies

这个命令会自动将Dusk升级到兼容的版本(如7.12.0)，该版本支持新版ChromeDriver的管理方式。

方法二：手动安装匹配的ChromeDriver

升级Dusk后，可以运行以下命令自动检测并安装匹配的驱动：

php artisan dusk:chrome-driver --detect

或者手动指定与浏览器匹配的版本：

php artisan dusk:chrome-driver 120

技术细节说明

从Chrome 115版本开始，Google改变了ChromeDriver的发布和管理方式：

1. 旧版(114及以下)使用传统的版本管理方式
2. 新版(115+)采用新的测试版发布渠道
3. Dusk 7.9.0及以上版本已适配新版管理机制

验证解决方案

成功解决问题后，开发者应该：

1. 确认ChromeDriver版本与浏览器版本匹配
2. 测试套件能够完整执行
3. 虽然可能仍有测试失败，但这些失败应该是业务逻辑问题而非环境问题

最佳实践建议

1. 定期更新Dusk和ChromeDriver版本
2. 在项目文档中记录测试环境的版本要求
3. 使用CI/CD时确保测试环境的版本一致性
4. 遇到测试挂起问题时，首先检查版本兼容性

通过以上分析和解决方案，开发者可以顺利在MacOS M3 Pro环境下使用Laravel Dusk进行浏览器自动化测试。