在 MacOS 上搭建 Selenium Java 与 ChromeDriver 自动化测试环境：从入门到实战

2026-02-01 22:19:56 0条评论 3次阅读 0人点赞

在软件开发领域，自动化测试已经成为保证质量和提高效率的关键环节。作为一名开发者，我们经常需要在 macOS 环境下搭建基于 Java 的 Selenium 自动化测试框架。然而，很多刚入行的朋友在配置环境时往往会遇到各种棘手的问题：ChromeDriver 版本不匹配、环境路径配置错误、依赖冲突等等。

别担心，在这篇文章中，我们将深入探讨如何在 macOS 上从零开始搭建 Selenium Java 与 ChromeDriver 的完整运行环境。我们不仅会涵盖基础的安装步骤，还会深入讲解底层原理，分享最佳实践，并帮你避开那些常见的“坑”。准备好了吗？让我们开始这段自动化测试的探索之旅吧。

为什么我们需要 ChromeDriver？

在正式开始之前，让我们先理解一下 ChromeDriver 到底扮演着什么角色。Selenium 是一个强大的工具，但它本身并不直接“认识” Google Chrome 浏览器。这就好比我们（Selenium）想指挥一辆汽车（Chrome 浏览器）行驶，但我们不懂汽车的语言。

这时，ChromeDriver 就登场了。它是一个充当“翻译官”角色的独立服务器。Selenium 发送标准的 WebDriver 命令给 ChromeDriver，ChromeDriver 将这些命令转化为 Chrome 浏览器能够理解的指令。因此，要让我们的自动化脚本跑起来，必须确保这个“翻译官”不仅在场，而且版本还要匹配。

步骤 1：准备 Java 开发环境

既然我们使用的是 Java 语言编写脚本，那么 macOS 上必须配置好 Java 运行环境（JRE 或 JDK）。Selenium 4.x 版本通常需要 Java 8 或更高版本的支持。

首先，让我们打开终端，检查一下你的机器上是否已经安装了 Java。

  • 打开终端并运行以下命令：
java -version

如果你看到了类似 INLINECODE89b83a77 的输出，恭喜你，可以直接跳过这一步。但如果终端提示 INLINECODE1f4fb6be，你需要安装 Java。

在 macOS 上，最优雅的方式是使用 Homebrew 来安装 OpenJDK。

# 安装 OpenJDK（推荐安装 LTS 版本，如 Java 17）
brew install openjdk

安装完成后，你可能需要将 Java 添加到系统路径中，以便系统可以全局识别它。Homebrew 安装结束时通常会提示具体的命令，一般如下：

# 为当前用户设置 Java 环境变量（根据实际版本号调整）
echo ‘export PATH="/usr/local/opt/openjdk/bin:$PATH"‘ >> ~/.zshrc
source ~/.zshrc

步骤 2：安装 Homebrew 包管理器

如果你还没有安装 Homebrew，这一步至关重要。Homebrew 是 macOS 上“缺失的包管理器”，它让我们能够非常轻松地安装和卸载开发工具，避免了手动去网上下载 DMG 文件的繁琐过程。

如果你的终端里输入 brew 没有反应，请在终端中执行以下官方安装脚本：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

这个过程可能需要输入你的 macOS 用户密码，并花费几分钟时间。安装完成后，记得根据提示将 Homebrew 加入到系统 PATH 中。通常你需要运行类似下面的命令（针对 Apple Silicon M1/M2/M3 芯片的 Mac）：

echo ‘eval "$(/opt/homebrew/bin/brew shellenv)"‘ >> ~/.zshrc
eval "$(/opt/homebrew/bin/brew shellenv)"

步骤 3：安装与配置 Google Chrome

Selenium 是通过驱动浏览器来工作的，所以被驱动的对象——Google Chrome 浏览器，必须事先安装好。

专业见解：保持 Chrome 浏览器处于最新版本非常重要。因为 ChromeDriver 通常会紧随 Chrome 的版本更新，旧版本的浏览器可能找不到对应的新驱动，或者存在已知的 Bug。在生产环境中，锁定浏览器版本也是防止脚本意外挂掉的一种策略。

步骤 4：安装 ChromeDriver 的两种策略

这是最关键的一步，也是出错率最高的环节。我们有两种主流的方法来安装 ChromeDriver：使用 Homebrew 自动安装，或者手动下载。

#### 方法 A：使用 Homebrew 自动安装（推荐）

Homebrew 提供了 chromedriver 的 cask，我们可以通过一行命令搞定。这是最省心的方法，因为 Homebrew 会自动处理 PATH 配置。

brew install --cask chromedriver

安装过程中，macOS 的安全机制可能会弹出一个警告，提示“无法打开 chromedriver，因为无法验证开发者”。这是因为 ChromeDriver 是一个二进制可执行文件。为了解决这个问题，我们需要在“系统设置” -> “隐私与安全性”中点击“仍要打开”，或者在终端运行以下命令来移除隔离属性（这是开发者常用的技巧）：

xattr -d com.apple.quarantine $(which chromedriver)

#### 方法 B：手动下载与配置

如果你需要特定版本的 ChromeDriver（例如为了匹配旧版 Chrome），你可以访问 ChromeDriver 官方下载页面。

  • 下载对应你 Chrome 版本的 driver。
  • 解压下载的文件，你会得到一个名为 chromedriver 的可执行文件。
  • 将其移动到系统路径下，比如 /usr/local/bin：
# 移动文件到系统 bin 目录
sudo mv /path/to/your/downloaded/chromedriver /usr/local/bin/chromedriver

# 赋予执行权限
sudo chmod +x /usr/local/bin/chromedriver

#### 验证安装

无论你使用哪种方法，最后请务必验证安装是否成功。打开终端，输入：

chromedriver --version

如果输出了版本号（例如 ChromeDriver 121.0.6167.85），说明我们就绪了！

步骤 5：在 IntelliJ IDEA 中搭建 Java 项目

环境配置好了，现在让我们把注意力转移到代码编写上。IntelliJ IDEA 是目前最流行的 Java IDE，我们将以此为例进行演示。

  • 创建新项目：打开 IDEA，选择 New Project。
  • 选择构建工具：这里强烈推荐使用 Maven 或 Gradle。这不仅是为了管理依赖，更是为了后续项目的可扩展性和标准化。如果你只是写个 Hello World，也可以选 Java，但为了实战，我们选 Maven。
  • 配置 pom.xml：Maven 项目的核心在于 pom.xml 文件。我们需要在这里告诉 Maven 去下载 Selenium 的库。

请将以下依赖代码复制到你的 INLINECODE3947daca 文件的 INLINECODE7e2357de 标签内：


    
    
        org.seleniumhq.selenium
        selenium-java
        4.16.1
    
    
    
    
        io.github.bonigarcia
        webdrivermanager
        5.6.2

注意：你可以访问 Maven Central Repository 查询并使用最新的版本号。版本过旧可能会导致不支持新版 Chrome 的特性。

步骤 6：编写第一个 Selenium 脚本

让我们来看一个实际的例子。我们将创建一个 Java 类，让它自动打开 Chrome，访问百度（或者 Google，取决于你的网络环境），搜索一个关键词，然后打印标题并退出。

#### 场景一：手动指定 Driver 路径（硬编码方式）

这是最基础的方式，有助于你理解底层原理，但在实际项目中并不推荐，因为路径一旦改变，代码就会挂掉。

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

public class BasicSeleniumTest {
    public static void main(String[] args) {
        // 1. 设置系统属性，告诉 Selenium ChromeDriver 在哪里
        // 注意：如果你使用了 Homebrew 安装，通常不需要设置这一步，因为它已经在 PATH 中了
        // 但如果报错，请取消下面的注释并填入你的路径
        // System.setProperty("webdriver.chrome.driver", "/usr/local/bin/chromedriver");

        // 2. 创建 ChromeDriver 实例
        // 这一步会自动启动一个新的 Chrome 浏览器会话
        WebDriver driver = new ChromeDriver();

        try {
            // 3. 导航到网址
            driver.get("https://www.baidu.com/");

            // 4. 验证：打印页面标题
            String pageTitle = driver.getTitle();
            System.out.println("当前页面标题是: " + pageTitle);

            // 简单的断言检查
            if (pageTitle.contains("百度")) {
                System.out.println("测试通过：成功访问百度首页！");
            } else {
                System.out.println("测试失败：页面标题异常。");
            }
        } finally {
            // 5. 关闭浏览器并结束会话
            // driver.quit() 会关闭所有窗口并彻底结束 WebDriver 进程
            driver.quit();
        }
    }
}

#### 场景二：使用 WebDriverManager（现代最佳实践）

你可能会遇到这样的烦恼：Chrome 浏览器自动更新了，结果你的 Selenium 脚本报错了，因为 ChromeDriver 版本没跟上。为了解决这个问题，我们可以使用 WebDriverManager 库。它会自动检测你的浏览器版本，并下载匹配的 Driver。

代码如下：

import io.github.bonigarcia.wdm.WebDriverManager;
import org.openqa.selenium.WebDriver;
import org.openqa.selenium.chrome.ChromeDriver;
import org.openqa.selenium.chrome.ChromeOptions;

public class ModernSeleniumTest {
    public static void main(String[] args) {
        // 1. 使用 WebDriverManager 自动设置 Driver
        // 这行代码会自动处理下载和配置，你甚至不需要安装 chromedriver 到系统
        WebDriverManager.chromedriver().setup();

        // 2. 可选：配置 Chrome 选项
        // 比如设置无头模式，或者忽略 SSL 证书错误等
        ChromeOptions options = new ChromeOptions();
        options.addArguments("--start-maximized"); // 启动时最大化
        // options.addArguments("--headless"); // 如果不想看到浏览器界面，可以开启这个

        // 3. 初始化 Driver 并传入配置
        WebDriver driver = new ChromeDriver(options);

        try {
            // 业务逻辑
            driver.get("https://www.selenium.dev/");
            System.out.println("Selenium 官网标题: " + driver.getTitle());
            
            // 模拟稍等，观察效果（实际测试中请使用显式等待）
            Thread.sleep(2000);
            
        } catch (InterruptedException e) {
            e.printStackTrace();
        } finally {
            driver.quit();
        }
    }
}

进阶：处理常见错误与最佳实践

在执行上述代码时，你可能会遇到一些挑战。让我们看看如何解决它们。

#### 1. “chromedriver”无法打开，因为无法验证开发者

这是 macOS 特有的安全限制。除了之前提到的 xattr 命令，你还可以在终端中手动允许它：

# 试图运行一次，这会触发系统的安全弹窗
chromedriver

然后打开“系统设置” -> “隐私与安全性”，在下方找到提示信息，点击“仍要打开”。

#### 2. SessionNotCreatedException: This version of ChromeDriver only supports Chrome version X

这个错误明确告诉我们：版本不匹配。

解决方案：

  • 要么更新你的 ChromeDriver 到最新版（brew upgrade --cask chromedriver）。
  • 要么，如果你必须使用旧版 Chrome，去手动下载对应版本的 Driver。
  • 或者，干脆使用上面提到的 WebDriverManager，它会帮你自动处理这些琐事。

#### 3. 元素定位速度慢或找不到元素

在测试动态网页时，页面加载需要时间。如果在元素还没出现时就点击它，脚本就会报 NoSuchElementException。

不要使用 Thread.sleep()！ 这是最糟糕的做法，因为它会让测试变慢且不稳定。
最佳实践：使用显式等待。

import org.openqa.selenium.support.ui.WebDriverWait;
import org.openqa.selenium.support.ui.ExpectedConditions;
import org.openqa.selenium.By;
import java.time.Duration;

// ... 在测试方法中

// 设置一个等待对象，最长等待 10 秒
WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));

// 等待直到某个元素可见
wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("su")));

// 然后再执行操作
driver.findElement(By.id("su")).click();

性能优化建议

当你开始运行大规模测试套件时，性能就变得尤为重要。

  • 使用 Headless 模式：如果你的测试不需要图形界面（比如在 CI/CD 流水线上），开启无头模式可以大幅提升速度并节省资源。
    •     options.addArguments("--headless=new"); // Selenium 4 推荐写法
  • 复用 Browser Session：不要每个测试用例都启动一次浏览器。在类级别或套件级别启动一次，测试结束后关闭，能显著减少总耗时。

结语

通过这篇文章，我们一步步完成了从环境准备到编写、运行第一个自动化测试的全过程。我们探讨了如何利用 Homebrew 简化安装流程，了解了手动配置和自动管理 Driver 的区别，并深入学习了如何编写健壮的测试代码。

你现在应该已经掌握了在 macOS 上配置 Selenium Java 和 ChromeDriver 的核心技能。自动化测试的世界非常广阔，这只是迈出了第一步。接下来，你可以尝试将你的脚本集成到 Jenkins 或 GitHub Actions 中，实现持续集成的自动化流程。如果在操作过程中遇到任何问题，记得回来看看这篇文章的故障排查部分。祝你在自动化测试的道路上越走越远！

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。如需转载，请注明文章出处豆丁博客和来源网址。https://shluqu.cn/20005.html
点赞
0.00 平均评分 (0% 分数) - 0 票

相关文章美国1G带宽/1T流量高速vps $17.99/年