Playwright-Python在macOS Sonoma上的浏览器版本不匹配问题解析

在macOS Sonoma系统上使用Playwright-Python进行自动化测试时，开发者可能会遇到一个典型问题：已安装的浏览器版本与实际使用的版本不匹配。这个问题通常会导致程序无法正常启动浏览器，并提示"Executable doesn't exist"错误。

问题现象

当开发者在M1芯片的Mac电脑上通过pip安装Playwright 1.44.0版本后，使用playwright install --dry-run命令查看时会显示安装的是Chromium 119.0.6045.9版本。然而在实际运行代码时，程序却尝试寻找Chromium 1117版本的路径，导致执行失败。

问题根源

经过分析，这种情况通常由以下两种原因导致：

1. 多版本冲突：系统上同时存在通过Homebrew和pip安装的Playwright，导致版本管理混乱。Homebrew和pip的安装路径不同，可能会互相干扰。

2. 缓存未更新：Playwright的浏览器缓存机制可能没有正确更新，导致程序仍然尝试使用旧版本的浏览器路径。

解决方案

1. 统一安装渠道：

   • 建议只通过pip安装Playwright，避免使用Homebrew等其他包管理器混合安装
   • 可以使用pip uninstall playwright彻底移除现有安装
   • 然后重新通过pip install playwright安装最新版本

2. 清理并重新安装浏览器：

   • 执行playwright uninstall清除所有已安装的浏览器
   • 然后运行playwright install重新下载最新版本的浏览器

3. 验证安装：

   • 使用playwright install --dry-run查看将要安装的浏览器版本
   • 通过playwright --version确认CLI工具版本
   • 确保pip列表中的版本与CLI工具版本一致

最佳实践建议

1. 虚拟环境使用：建议在Python虚拟环境中安装Playwright，避免与其他全局安装的包产生冲突。

2. 版本一致性检查：在项目中明确指定Playwright的版本号，确保开发环境和生产环境使用相同版本。

3. 路径验证：在代码中添加路径验证逻辑，可以在浏览器启动前检查可执行文件是否存在。

4. 错误处理：完善错误处理机制，当遇到浏览器路径问题时能够给出更友好的提示。

总结

Playwright-Python在macOS上的浏览器版本不匹配问题通常是由于安装渠道混乱或缓存未更新导致的。通过统一安装渠道、清理旧版本并重新安装，可以有效地解决这个问题。对于Python开发者来说，保持开发环境的整洁和一致性是避免此类问题的关键。

对于使用M1/M2芯片的Mac用户，还需要特别注意选择arm64架构的浏览器版本，以获得最佳的性能和兼容性体验。