1. 项目概述：基于Java+Playwright+TestNG的UI自动化测试方案
最近在重构团队的UI自动化测试框架时，我选择了Playwright这个新兴的测试工具配合Java和TestNG搭建了一套高效的测试方案。这套组合拳在实际项目中表现非常出色，特别是对于现代Web应用（如SPA）的测试支持相当完善。相比传统的Selenium方案，Playwright的异步执行模型和内置等待机制让测试脚本更加稳定可靠。
这个方案特别适合以下场景：
- 需要测试包含大量动态内容的现代Web应用
- 现有Selenium测试存在大量flaky tests（不稳定的测试用例）
- 团队已经具备Java技术栈，希望复用现有测试基础设施
- 需要跨浏览器（Chromium/WebKit/Firefox）的自动化测试能力
2. 技术栈选型与核心组件
2.1 为什么选择Playwright？
Playwright是微软开源的现代化浏览器自动化工具，相比Selenium有以下几个显著优势：
- 多浏览器支持：一套API同时支持Chromium、WebKit和Firefox
- 自动等待机制：内置智能等待，无需手动添加sleep
- 网络拦截能力：可以直接mock网络请求和响应
- 设备模拟：支持移动设备视口和User-Agent模拟
- 视频录制：测试过程可以自动录屏便于问题排查
实际使用中发现，Playwright对React/Vue等现代前端框架的支持特别好，能自动等待动态加载的内容。
2.2 TestNG作为测试框架的优势
TestNG相比JUnit在测试组织和管理上更加强大：
- 灵活的测试分组(group)和依赖管理
- 参数化测试支持更完善
- 丰富的监听器(Listener)机制
- 内置HTML报告生成
- 并行测试执行能力
2.3 Maven项目配置
基础pom.xml依赖配置如下：
<dependencies> <!-- Playwright Java SDK --> <dependency> <groupId>com.microsoft.playwright</groupId> <artifactId>playwright</artifactId> <version>1.40.0</version> </dependency> <!-- TestNG --> <dependency> <groupId>org.testng</groupId> <artifactId>testng</artifactId> <version>7.8.0</version> <scope>test</scope> </dependency> <!-- 日志框架 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>2.0.7</version> </dependency> </dependencies>3. 核心实现与最佳实践
3.1 测试基类设计
建议抽象一个基础测试类处理Playwright的初始化和清理：
public class BaseTest { protected Playwright playwright; protected Browser browser; protected BrowserContext context; protected Page page; @BeforeSuite public void launchBrowser() { playwright = Playwright.create(); browser = playwright.chromium().launch( new BrowserType.LaunchOptions().setHeadless(false) ); } @BeforeMethod public void createContext(ITestContext testContext) { context = browser.newContext(); page = context.newPage(); } @AfterMethod public void closeContext() { context.close(); } @AfterSuite public void closeBrowser() { browser.close(); playwright.close(); } }3.2 页面对象模式实现
对于复杂的页面交互，推荐使用页面对象模式：
public class LoginPage { private final Page page; // 定位器 private final Locator usernameInput; private final Locator passwordInput; private final Locator submitButton; public LoginPage(Page page) { this.page = page; this.usernameInput = page.locator("#username"); this.passwordInput = page.locator("#password"); this.submitButton = page.locator("#submit"); } public void navigateToLogin() { page.navigate("https://example.com/login"); } public void login(String username, String password) { usernameInput.fill(username); passwordInput.fill(password); submitButton.click(); } }3.3 测试用例编写示例
结合TestNG的测试类示例：
public class LoginTests extends BaseTest { @Test public void testSuccessfulLogin() { LoginPage loginPage = new LoginPage(page); loginPage.navigateToLogin(); loginPage.login("validUser", "validPass"); assertThat(page).hasURL("https://example.com/dashboard"); } @Test public void testFailedLogin() { LoginPage loginPage = new LoginPage(page); loginPage.navigateToLogin(); loginPage.login("invalid", "credentials"); Locator errorMessage = page.locator(".error-message"); assertThat(errorMessage).hasText("Invalid username or password"); } }4. 高级特性与优化技巧
4.1 并行测试执行
TestNG支持通过XML配置实现并行测试：
<suite name="Playwright Suite" parallel="methods" thread-count="3"> <test name="Login Tests"> <classes> <class name="com.example.tests.LoginTests"/> </classes> </test> </suite>配合Playwright的BrowserContext隔离机制，每个测试方法都会获得独立的浏览器上下文，避免状态污染。
4.2 网络请求拦截
Playwright强大的网络API可以用于：
// 拦截所有请求 page.route("**/*", route -> { if (route.request().url().contains("analytics")) { route.abort(); // 屏蔽分析请求 } else { route.continue_(); } }); // Mock API响应 page.route("**/api/user", route -> { route.fulfill(new Route.FulfillOptions() .setContentType("application/json") .setBody("{\"name\":\"Mock User\"}")); });4.3 视频录制与追踪
在BrowserContext创建时启用录制：
@BeforeMethod public void createContext(ITestContext testContext) { context = browser.newContext(new Browser.NewContextOptions() .setRecordVideoDir(Paths.get("videos/")) .setRecordVideoSize(1280, 720)); // 同时启用追踪 context.tracing().start(new Tracing.StartOptions() .setScreenshots(true) .setSnapshots(true)); page = context.newPage(); } @AfterMethod public void closeContext(Method method) { // 保存追踪数据 context.tracing().stop(new Tracing.StopOptions() .setPath(Paths.get("traces/" + method.getName() + ".zip"))); context.close(); }5. 常见问题与解决方案
5.1 元素定位问题
Playwright提供了多种定位策略：
// 最佳实践优先级 page.locator("button:has-text('Submit')"); // 1. 文本+角色 page.locator("#login-form >> button.submit"); // 2. CSS组合 page.locator("//button[@id='submit']"); // 3. XPath（最后考虑）实际项目中发现，使用文本定位配合适当的语义化角色通常最稳定，避免了因CSS类名变化导致的测试失败。
5.2 异步操作处理
Playwright内置自动等待，但某些场景需要显式等待：
// 等待元素可见 page.locator(".loading-spinner").waitFor(new Locator.WaitForOptions() .setState(WaitForSelectorState.HIDDEN)); // 等待网络请求完成 page.waitForResponse(response -> response.url().contains("/api/data") && response.status() == 200, () -> page.click("#load-data") );5.3 测试数据管理
推荐使用TestNG的@DataProvider实现参数化测试：
@DataProvider(name = "loginCredentials") public Object[][] provideLoginData() { return new Object[][] { {"admin", "admin123", true}, {"locked", "password", false}, {"", "secret", false} }; } @Test(dataProvider = "loginCredentials") public void testParameterizedLogin(String user, String pass, boolean expected) { LoginPage loginPage = new LoginPage(page); loginPage.navigateToLogin(); loginPage.login(user, pass); if (expected) { assertThat(page).hasURL(containsString("/dashboard")); } else { assertThat(page.locator(".error")).isVisible(); } }6. 持续集成配置
6.1 GitHub Actions示例
name: Playwright Tests on: [push, pull_request] jobs: test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v3 - uses: actions/setup-java@v3 with: java-version: '17' distribution: 'temurin' - name: Run Playwright tests run: mvn test -Dheadless=true - name: Upload artifacts uses: actions/upload-artifact@v3 if: always() with: name: test-results path: | target/surefire-reports/ videos/ traces/6.2 容器化执行
Dockerfile配置示例：
FROM maven:3.8.6-eclipse-temurin-17 # 安装Playwright依赖 RUN apt-get update && \ apt-get install -y libgbm-dev && \ rm -rf /var/lib/apt/lists/* WORKDIR /app COPY pom.xml . RUN mvn dependency:go-offline COPY src ./src CMD ["mvn", "test", "-Dheadless=true"]这套Java+Playwright+TestNG的UI自动化测试方案在我们团队已经稳定运行半年多，测试稳定性从原来的70%提升到了98%，维护成本降低了约40%。特别是Playwright的自动等待和网络拦截功能，大大减少了flaky tests的出现。对于已经使用Java技术栈的团队，这个组合无疑是最平滑的现代化测试方案迁移路径。
