1. 项目概述为什么M1 Mac上的Selenium需要“特供”Chromedriver如果你是一名在M1/M2/M3芯片的Mac上进行Web自动化测试的开发者大概率踩过这个坑兴致勃勃地写好了Selenium脚本一运行却弹出一个“无法打开‘chromedriver’因为无法验证开发者”的提示或者直接报错“zsh: killed”。这背后正是我们今天要聊的核心——为M1优化的Chromedriver。这不仅仅是一个简单的驱动文件替换而是从指令集架构到系统安全策略的一次完整适配。对于从Intel Mac迁移过来的开发者或者新入手苹果芯片Mac的测试工程师来说理解这其中的差异是搭建稳定、高效自动化测试环境的第一步。简单来说Chromedriver是Selenium控制Chrome浏览器的“桥梁”或“遥控器”。传统的Chromedriver是为x86_64架构编译的而苹果的M系列芯片采用的是ARM64架构。虽然MacOS内置的Rosetta 2转译层能让大部分Intel应用“无感”运行但对于Chromedriver这种需要与底层系统、浏览器进程深度交互的二进制工具转译运行常常会引入不稳定因素比如内存访问异常、性能损耗甚至直接被系统的安全机制如Gatekeeper终止。因此一个原生为ARM64架构编译的Chromedriver是确保Selenium在M1 Mac上流畅、可靠运行的基石。本文将带你彻底搞清如何为你的M1 Mac获取、配置并优化这个关键组件避开所有常见的“坑”。2. 核心需求解析M1架构带来的挑战与机遇2.1 架构差异从x86到ARM的本质变化Intel处理器使用的x86_64或amd64指令集与苹果自研M系列芯片使用的ARM64指令集是两种完全不同的计算语言。Rosetta 2作为翻译官虽然强大但并非万能。它在运行时动态将x86指令翻译成ARM指令这个过程会带来两个直接影响一是性能开销对于计算密集或频繁进行系统调用的程序性能损失可能超过20%二是兼容性风险某些涉及特定CPU特性或低级系统调用的操作在转译时可能行为异常。Chromedriver需要与Chrome浏览器通过DevTools Protocol进行高速、精确的进程间通信IPC任何微小的延迟或不稳定都可能导致元素定位超时、脚本执行失败。因此原生ARM64版本的Chromedriver能彻底消除转译层带来的不确定性实现与系统及浏览器的“原生对话”。2.2 系统安全策略Gatekeeper与公证Notarization自macOS Catalina起苹果强化了Gatekeeper安全机制。对于从未知开发者即未经过苹果公证下载的应用系统会默认阻止其运行。从官网下载的通用版Chromedriver通常未经过苹果的公证流程。当你在M1 Mac上首次运行它时系统会弹出警告甚至直接拒绝。你需要手动在“系统设置”-“隐私与安全性”中点击“仍要打开”这显然不适合自动化流程。而为M1优化的版本或通过Homebrew等受信任渠道安装的版本往往已经处理了公证问题或者提供了绕过此限制的更优方案。理解这一点能帮你避免脚本在CI/CD流水线或定时任务中因权限问题而意外中断。2.3 性能与稳定性诉求自动化测试尤其是UI层级的测试对稳定性要求极高。一个不稳定的驱动会导致测试用例时好时坏Flaky Tests极大地损害测试套件的可信度。原生ARM64 Chromedriver带来的最直接好处就是稳定性的显著提升。它减少了因架构转译导致的内存错误和进程崩溃几率。同时由于直接使用ARM指令集在执行一些密集型操作如处理大量DOM元素、执行复杂JavaScript或进行截图对比时也能获得更好的性能表现从而缩短测试执行时间。3. 环境准备与工具选型3.1 确认你的Mac芯片类型这是所有操作的起点。打开“关于本机”屏幕左上角苹果菜单 - 关于本机查看“芯片”一项。如果显示“Apple M1”、“Apple M2”等那么你就需要ARM64版本的Chromedriver。也可以打开终端Terminal输入以下命令uname -m如果输出是arm64那么你的系统是运行在Apple Silicon原生模式下的。如果输出是x86_64则可能是你通过Rosetta 2打开的终端此时可以打开终端在“简介”中确认“使用Rosetta打开”是否被勾选。3.2 浏览器与驱动的版本对齐原则这是Selenium工作的黄金法则Chromedriver的主版本号必须与已安装的Chrome浏览器的主版本号完全一致。例如你安装了Chrome 124那么就必须使用Chromedriver 124.x.x.x。版本不匹配是绝大多数“无法启动浏览器”或“连接失败”错误的根源。查看Chrome版本打开Chrome在地址栏输入chrome://version/第一行“Google Chrome”后面就是完整版本号记下主版本号如124。驱动命名从官网下载时文件名通常包含版本号和平台信息如chromedriver-mac-arm64.zip就是ARM64版本。3.3 包管理工具推荐Homebrew vs 手动管理对于Mac用户管理Chromedriver主要有两种方式Homebrew推荐这是最优雅、最省心的方式。Homebrew Cask可以直接安装匹配当前Chrome版本的Chromedriver并自动处理路径和更新。# 安装Homebrew如果尚未安装 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) # 使用Homebrew安装Chromedriver brew install --cask chromedriver安装后Homebrew会提示你进行一些安全设置例如将chromedriver从隔离区移出并告诉你驱动被安装到了哪个路径通常是/usr/local/bin/chromedriver或/opt/homebrew/bin/chromedriver这个路径通常已在系统的PATH环境变量中。手动下载与管理这种方式更灵活适合需要固定特定版本或进行多版本并存的场景。你需要前往 Chromedriver官方下载站 或 Chrome for Testing 页面找到对应版本和平台mac-arm64的zip包下载后解压并将可执行文件放置到系统路径下。注意从官网直接下载的chromedriver在首次运行时大概率会遇到“无法打开因为无法验证开发者”的提示。除了在系统设置中手动允许外更一劳永逸的命令行解决方法是在解压出chromedriver文件后于其所在目录执行xattr -c chromedriver这个命令会移除其上的“扩展属性”quarantine属性Gatekeeper便不会再拦截。但请注意这略微降低了安全门槛请确保你从官方渠道下载文件。4. 详细配置与集成步骤4.1 使用Homebrew安装并配置假设你选择Homebrew方式安装完成后还需要进行验证和可能的路径配置。验证安装在终端输入chromedriver --version。如果正确输出版本信息且与你的Chrome主版本号一致说明安装成功。处理公证警告如果出现首次运行chromedriver命令时可能仍会弹出安全警告。按照提示进入“系统设置”-“隐私与安全性”点击“仍要允许”即可。之后便不会再出现。在Selenium代码中指定路径通常不需要如果Homebrew安装后直接在终端输入which chromedriver能找到路径那么在Python的Selenium代码中通常不需要显式指定驱动路径WebDriver会自动在PATH中查找。但为了绝对可靠你可以显式指定from selenium import webdriver from selenium.webdriver.chrome.service import Service # 指定chromedriver的绝对路径 service Service(/opt/homebrew/bin/chromedriver) # 根据你的实际路径调整 driver webdriver.Chrome(serviceservice)4.2 手动下载与配置流程如果你需要手动管理特定版本请遵循以下步骤确定Chrome版本如前所述访问chrome://version/记录主版本号例如124。下载对应驱动访问 Chrome for Testing 页面。这是一个更现代的、专门为测试提供的渠道。找到“Stable”频道下对应版本如124.0.6367.91下载chromedriver-mac-arm64.zip。解压与放置# 解压下载的zip文件 unzip ~/Downloads/chromedriver-mac-arm64.zip -d ~/Downloads/ # 将解压出的二进制文件移动到系统可执行路径并赋予执行权限 sudo mv ~/Downloads/chromedriver-mac-arm64/chromedriver /usr/local/bin/ sudo chmod x /usr/local/bin/chromedriver/usr/local/bin是一个常见的用户级可执行文件存放路径。你也可以选择~/bin需要确保该目录在PATH中。移除隔离属性sudo xattr -c /usr/local/bin/chromedriver验证打开新终端执行chromedriver --version确认版本输出正确。4.3 在Python项目中集成以pytest为例一个良好的测试项目结构有助于管理驱动。假设你的项目结构如下my_automation_project/ ├── drivers/ │ └── chromedriver (你的ARM64版本驱动放在这里) ├── tests/ │ ├── conftest.py │ └── test_example.py └── requirements.txt你可以在conftest.py中配置一个pytest fixture来管理浏览器的生命周期并指定驱动路径# conftest.py import pytest from selenium import webdriver from selenium.webdriver.chrome.service import Service from pathlib import Path def pytest_addoption(parser): parser.addoption(--headless, actionstore_true, defaultFalse, helpRun tests in headless mode) pytest.fixture(scopesession) def driver(request): 提供WebDriver实例的Fixture chrome_options webdriver.ChromeOptions() # 根据命令行参数决定是否无头运行 if request.config.getoption(--headless): chrome_options.add_argument(--headlessnew) # 推荐使用new headless模式 # 其他常用选项 chrome_options.add_argument(--no-sandbox) # 在CI环境或某些配置下可能需要 chrome_options.add_argument(--disable-dev-shm-usage) # 解决共享内存问题 chrome_options.add_argument(--window-size1920,1080) # 关键指定ARM64 chromedriver的路径 driver_path Path(__file__).parent.parent / drivers / chromedriver service Service(executable_pathstr(driver_path)) driver_instance webdriver.Chrome(serviceservice, optionschrome_options) driver_instance.implicitly_wait(10) # 设置隐式等待 yield driver_instance # 测试结束后退出浏览器 driver_instance.quit() # test_example.py def test_visit_homepage(driver): 使用fixture提供的driver进行测试 driver.get(https://www.example.com) assert Example in driver.title这样你只需将对应版本的ARM64 chromedriver放入drivers/目录所有测试用例都能通过driverfixture使用它。5. 高级配置与性能优化5.1 ChromeOptions的针对性配置针对M1 Mac和自动化测试场景一些ChromeOptions的设置能极大提升体验chrome_options webdriver.ChromeOptions() # 1. 使用新的Headless模式性能更好更接近真实浏览器 chrome_options.add_argument(--headlessnew) # 2. 禁用GPU加速在无头模式下有时可避免问题 chrome_options.add_argument(--disable-gpu) # 3. 禁用沙盒仅在受信任的测试环境或容器中使用有安全风险 # chrome_options.add_argument(--no-sandbox) # 4. 避免使用/dev/shm使用/tmp替代防止内存不足 chrome_options.add_argument(--disable-dev-shm-usage) # 5. 设置默认下载目录避免弹窗 prefs {download.default_directory: /path/to/downloads} chrome_options.add_experimental_option(prefs, prefs) # 6. 忽略证书错误用于测试环境 chrome_options.add_argument(--ignore-certificate-errors)5.2 使用Driver Manager简化版本管理手动管理驱动版本很繁琐。社区库webdriver-manager可以自动下载、缓存并匹配正确版本的驱动。虽然它主要面向x86但通过一些配置也能支持ARM64。from selenium import webdriver from selenium.webdriver.chrome.service import Service from webdriver_manager.chrome import ChromeDriverManager from webdriver_manager.core.os_manager import ChromeType service Service(ChromeDriverManager(chrome_typeChromeType.CHROMIUM).install()) driver webdriver.Chrome(serviceservice)注意webdriver-manager需要正确识别系统架构。在M1 Mac上确保你运行在原生ARM终端下它应该能自动下载mac_arm64版本。但有时可能需要指定版本建议先手动确认其下载的驱动是否为ARM64格式。5.3 容器化方案Docker for Mac (Apple Silicon)对于追求环境一致性的团队使用Docker是终极方案。你需要寻找或构建包含ARM64架构Chrome和Chromedriver的Docker镜像。确保你的Docker Desktop已更新到支持Apple Silicon的版本。使用官方的selenium/standalone-chrome镜像并确认其有ARM64标签的版本。编写Dockerfile或使用docker-compose将你的测试代码挂载到容器中运行。# docker-compose.yml 示例 version: 3.8 services: selenium: image: seleniarm/standalone-chromium:latest # 注意是seleniarm这是ARM64版本的Selenium镜像 shm_size: 2gb ports: - 4444:4444 - 7900:7900 tests: build: . depends_on: - selenium environment: - SELENIUM_REMOTE_URLhttp://selenium:4444/wd/hub volumes: - ./tests:/tests这种方式完全隔离了宿主机环境无论在Intel Mac、M1 Mac还是Linux服务器上测试运行环境都完全一致。6. 实战问题排查与调试技巧6.1 常见错误与解决方案以下是在M1 Mac上使用Selenium和Chromedriver时我遇到并总结的典型问题错误现象可能原因解决方案SessionNotCreatedException: Message: session not created: This version of ChromeDriver only supports Chrome version XXChromedriver与Chrome浏览器版本不匹配。1. 检查Chrome版本 (chrome://version)。2. 下载完全匹配主版本号的Chromedriver。使用brew upgrade chromedriver或手动下载。zsh: killed或进程立即退出1. 使用了x86版本的Chromedriver在ARM Mac上运行。2. 文件损坏或权限问题。1. 确认下载的是mac-arm64版本。2. 运行file $(which chromedriver)输出应包含Mach-O 64-bit executable arm64。3. 重新下载并确保执行了chmod x。“无法打开‘chromedriver’因为无法验证开发者”Gatekeeper安全拦截。1. 系统设置中手动允许。2. 推荐在终端执行xattr -c /path/to/chromedriver。WebDriverException: Message: unknown error: cannot find Chrome binarySelenium找不到Chrome安装位置。1. 确保Chrome已安装。2. 在ChromeOptions中显式指定二进制路径chrome_options.binary_location /Applications/Google Chrome.app/Contents/MacOS/Google Chrome脚本运行缓慢CPU占用高可能在使用Rosetta转译运行x86驱动。务必切换到原生ARM64版本的Chromedriver和Chrome。无头模式Headless下元素定位失败新旧无头模式行为差异。使用--headlessnew参数这是Chrome 109推荐的新无头模式更接近真实浏览器。6.2 诊断与日志收集当遇到复杂问题时启用详细日志能帮你快速定位。启用Chromedriver日志在Service对象中指定日志输出。service Service(executable_path/path/to/chromedriver, service_args[--verbose, --log-pathchromedriver.log])启用Chrome浏览器日志chrome_options.add_argument(--enable-logging) chrome_options.add_argument(--v1) # 日志详细级别使用浏览器开发者工具对于非无头模式你可以直接按F12打开开发者工具在Console和Network面板查看错误和请求这对于调试页面交互问题至关重要。6.3 稳定性增强实践显式等待优于隐式等待隐式等待implicitly_wait是全局设置不够灵活。推荐使用WebDriverWait配合expected_conditions进行显式等待针对特定条件轮询。from selenium.webdriver.common.by import By from selenium.webdriver.support.ui import WebDriverWait from selenium.webdriver.support import expected_conditions as EC element WebDriverWait(driver, 10).until( EC.presence_of_element_located((By.ID, myDynamicElement)) )页面加载策略设置page_load_strategy为none或eager可以避免在加载缓慢的页面上长时间阻塞但需要配合良好的等待策略。chrome_options.page_load_strategy eager # 等待DOMContentLoaded不等待图片等资源进程清理确保测试结束后正确调用driver.quit()而不是driver.close()。quit()会关闭所有窗口并终止WebDriver进程释放资源。在fixture或teardown方法中实现。7. 持续集成CI环境下的考量在CI流水线如GitHub Actions, GitLab CI, Jenkins中运行Selenium测试环境是全新的配置必须自动化且可靠。GitHub Actions (macos-latest runner)GitHub提供的Mac运行器已经是Apple Silicon芯片。你的工作流步骤需要包括jobs: test: runs-on: macos-latest steps: - uses: actions/checkoutv4 - name: Set up Python uses: actions/setup-pythonv5 with: { python-version: 3.11 } - name: Install Chrome run: | brew install --cask google-chrome - name: Install Chromedriver run: | brew install --cask chromedriver - name: Install dependencies run: pip install -r requirements.txt - name: Run tests run: pytest --headless注意CI环境中通常需要以无头模式 (--headless) 运行。使用官方Docker镜像如前所述使用seleniarm/standalone-chromium等ARM64 Docker镜像是最佳实践它能保证环境绝对一致。在CI中你可以启动一个Selenium服务容器然后让你的测试运行器容器与之通信。驱动缓存为了加速CI构建可以将下载的Chromedriver缓存起来。在GitHub Actions中可以使用actions/cache动作缓存Homebrew的安装目录或手动下载的驱动路径。踩过几次坑之后我的体会是在M1 Mac上玩转Selenium第一步也是最关键的一步就是搞定那个“对”的Chromedriver。它就像一把精准的钥匙架构对得上ARM64版本对得上与Chrome一致系统才认公证或属性处理。一旦这个基础打牢了剩下的写脚本、搞框架、上CI都是水到渠成的事。别再让版本不匹配或架构错误这种低级问题浪费你的时间了从源头把它配置好你的自动化测试之路就成功了一大半。