Playwright自动化测试入门：从零搭建Java+Maven环境到第一个脚本实战

最新推荐文章于 2026-06-20 14:02:41 发布

原创

最新推荐文章于 2026-06-20 14:02:41 发布 · 806 阅读

标签

#Playwright #自动化测试 #Java #Maven

Playwright自动化测试实战：Java开发者从零到一的完整落地指南

如果你是一名Java开发者，正在为Web应用寻找一个可靠、高效且现代化的端到端测试方案，那么Playwright很可能就是你工具箱里缺失的那块拼图。我最初接触它是在一个大型电商项目的测试重构中，当时我们被Selenium的稳定性问题和繁琐的配置折磨得够呛。在尝试了Playwright之后，整个团队的测试执行速度和可靠性都上了一个台阶。这篇文章不会重复那些随处可见的官方文档，而是聚焦于Java技术栈，分享如何在一个真实的Maven项目中，从零开始集成Playwright，避开那些我踩过的坑，并快速编写出第一个可投入使用的自动化脚本。无论你是想提升现有测试套件的质量，还是为全新的项目搭建自动化测试基础，这里的内容都能提供一条清晰的路径。

1. 环境准备与Maven集成：为Java项目量身定制

在开始编写任何测试代码之前，一个稳定、高效的开发环境是基石。对于Java项目，这意味着我们需要处理好Maven依赖和浏览器二进制文件的下载问题。

1.1 创建项目与添加核心依赖

首先，使用你熟悉的IDE（如IntelliJ IDEA或Eclipse）创建一个标准的Maven项目。在 pom.xml 文件中，添加Playwright的Java客户端依赖。目前，Playwright的Java版本迭代迅速，建议使用官方仓库中的最新稳定版。

<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>playwright-demo</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <playwright.version>1.40.0</playwright.version> <!-- 请检查并更新为最新版本 -->
    </properties>

    <dependencies>
        <!-- Playwright Java 核心库 -->
        <dependency>
            <groupId>com.microsoft.playwright</groupId>
            <artifactId>playwright</artifactId>
            <version>${playwright.version}</version>
        </dependency>
        <!-- 可选：如果你计划使用Playwright Test Runner进行更结构化的测试 -->
        <!--
        <dependency>
            <groupId>com.microsoft.playwright</groupId>
            <artifactId>playwright-test</artifactId>
            <version>${playwright.version}</version>
            <scope>test</scope>
        </dependency>
        -->
    </dependencies>
</project>

注意：依赖添加后，首次执行Maven构建时，Playwright会自动下载所需的浏览器二进制文件（Chromium、Firefox、WebKit）。这个过程可能会花费一些时间，并且下载速度很大程度上取决于你的网络环境。

1.2 加速：配置国内Maven镜像与Playwright镜像

默认的Maven中央仓库和Playwright的浏览器下载源在国外，速度可能很不理想。为了提升体验，强烈建议进行以下配置：

配置Maven镜像：在用户目录下的 .m2/settings.xml 文件中（若没有则创建），添加阿里云等国内镜像。

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/central</url>
    </mirror>
</mirrors>

配置Playwright下载镜像：Playwright允许通过环境变量指定浏览器下载的镜像站，这对于国内开发者至关重要。

# Linux/Mac
export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright

# Windows (PowerShell)
$env:PLAYWRIGHT_DOWNLOAD_HOST="https://npmmirror.com/mirrors/playwright"

# 或者在代码中设置系统属性（需在初始化Playwright之前）
System.setProperty("PLAYWRIGHT_DOWNLOAD_HOST", "https://npmmirror.com/mirrors/playwright");

我通常会在项目的 README.md 或初始化脚本中明确写出这个环境变量的设置方法，确保团队每个成员都能快速完成配置。

1.3 验证安装与浏览器管理

依赖配置完成后，可以编写一个简单的验证脚本来检查环境是否就绪。这个脚本会尝试启动一个浏览器并访问一个页面。

package com.example.playwright;

import com.microsoft.playwright.*;

public class EnvValidation {
    public static void main(String[] args) {
        // 1. 创建Playwright实例
        try (Playwright playwright = Playwright.create()) {
            // 2. 选择浏览器类型，这里以Chromium为例
            BrowserType chromium = playwright.chromium();
            
            // 3. 配置启动选项：设置为有头模式以便观察
            BrowserType.LaunchOptions launchOptions = new BrowserType.LaunchOptions()
                    .setHeadless(false); // 设置为true则在后台无界面运行

            // 4. 启动浏览器
            try (Browser browser = chromium.launch(launchOptions)) {
                System.out.println("✅ 浏览器启动成功: " + browser.browserType().name());

                // 5. 创建浏览器上下文和页面
                BrowserContext context = browser.newContext();
                Page page = context.newPage();

                // 6. 导航到测试页面
                page.navigate("https://playwright.dev/java/");
                System.out.println("📄 页面标题: " + page.title());

                // 7. 等待3秒以便观察，然后关闭
                page.waitForTimeout(3000);
            }
        } catch (Exception e) {
            System.err.println("❌ 环境验证失败: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

运行这个类，如果一切顺利，你会看到一个浏览器窗口打开，加载Playwright官网，并在控制台打印出页面标题。这标志着你的基础环境已经搭建成功。