環(huán)境不穩(wěn)、用例亂跳？Playwright自動(dòng)化避坑大全

一、測(cè)試環(huán)境不穩(wěn)定

即使你的腳本寫得再完美，如果測(cè)試環(huán)境自身不穩(wěn)定，也會(huì)導(dǎo)致測(cè)試失敗。

常見原因：

1. 網(wǎng)絡(luò)波動(dòng)：測(cè)試機(jī)與被測(cè)系統(tǒng)之間的網(wǎng)絡(luò)不穩(wěn)定。

2. 依賴服務(wù)宕機(jī)/異常：被測(cè)系統(tǒng)依賴的微服務(wù)、數(shù)據(jù)庫(kù)、消息隊(duì)列等出現(xiàn)問題。

3. 服務(wù)器負(fù)載過高：被測(cè)系統(tǒng)或測(cè)試環(huán)境服務(wù)器資源緊張，導(dǎo)致響應(yīng)緩慢。

4. 環(huán)境配置差異：CI/CD 環(huán)境與本地開發(fā)環(huán)境的配置不一致。

Playwright 定位與解決技巧：

1. 容器化測(cè)試環(huán)境

Docker/Kubernetes：使用容器化技術(shù)（Docker Compose, Kubernetes）構(gòu)建一致且可重復(fù)部署的測(cè)試環(huán)境。Playwright 官方提供了 Docker 鏡像，非常方便在 CI/CD 中部署。

好處：確保每次運(yùn)行都在相同的、干凈的環(huán)境下，排除環(huán)境配置差異導(dǎo)致的問題。

# 示例：使用 Playwright 官方 Docker 鏡像運(yùn)行測(cè)試docker run -it --rm -v $(pwd):/app -w /app mcr.microsoft.com/playwright/python:latest /bin/bash -c "pip install -r requirements.txt && pytest"

2. 監(jiān)控與告警

基礎(chǔ)設(shè)施監(jiān)控：實(shí)時(shí)監(jiān)控測(cè)試環(huán)境的 CPU、內(nèi)存、網(wǎng)絡(luò)、磁盤 IO 等指標(biāo)。

服務(wù)健康檢查：監(jiān)控所有被測(cè)系統(tǒng)及其依賴服務(wù)的健康狀態(tài)。

告警機(jī)制：一旦發(fā)現(xiàn)異常，及時(shí)通過郵件、短信或企業(yè)微信通知相關(guān)人員。

3. 依賴服務(wù) Mock/Stub

對(duì)于外部或不穩(wěn)定的依賴服務(wù)，考慮使用 Mock 或 Stub 技術(shù)模擬其響應(yīng)，減少外部因素的干擾，提高測(cè)試穩(wěn)定性。Playwright 提供了強(qiáng)大的網(wǎng)絡(luò)攔截功能。

# 攔截并 Mock 特定 API 響應(yīng)page.route("**/api/user/**", lambda route: route.fulfill( status=200, content_type="application/json", body='{"username": "mocked_user", "id": 123}'))# 也可以攔截圖片、字體等資源，加速測(cè)試或模擬加載失敗page.route("**/*.{png,jpg,jpeg,svg}", lambda route: route.abort())

二、閃爍測(cè)試

“閃爍測(cè)試”是指在代碼和環(huán)境都沒有變化的情況下，時(shí)而通過、時(shí)而失敗的測(cè)試用例。它們是自動(dòng)化測(cè)試工程師的噩夢(mèng)，極大地降低了測(cè)試結(jié)果的信任度。

常見原因：

1. 競(jìng)態(tài)條件：腳本與應(yīng)用之間或應(yīng)用內(nèi)部的異步操作競(jìng)爭(zhēng)資源，導(dǎo)致執(zhí)行順序不確定。

2. 不充分的等待：顯式等待的時(shí)間或條件設(shè)置不合理，未能完全覆蓋異步操作完成的時(shí)間。

3. 隨機(jī)數(shù)或時(shí)間依賴：測(cè)試邏輯依賴于系統(tǒng)時(shí)間、隨機(jī)數(shù)等非確定性因素。

4. 外部系統(tǒng)不穩(wěn)定：依賴的第三方服務(wù)、外部 API 等不穩(wěn)定。

5. 瀏覽器/驅(qū)動(dòng)問題：瀏覽器或 WebDriver 自身偶爾出現(xiàn)的非預(yù)期行為。

6. 測(cè)試用例耦合：用例之間存在隱式依賴，導(dǎo)致一個(gè)用例的失敗影響其他用例。

Playwright 定位與解決技巧：

Playwright 及其測(cè)試框架（Playwright Test）提供了多項(xiàng)強(qiáng)大功能來(lái)對(duì)抗 Flaky Tests：

1. Playwright Test 的自動(dòng)重試機(jī)制

Playwright Test Runner 內(nèi)置了重試機(jī)制。在 `playwright.config.ts` (或 `pytest-playwright` 配置) 中設(shè)置 `retries` 參數(shù)。

● 在 `playwright.config.ts` (JS/TS):

import { defineConfig } from '@playwright/test';exportdefaultdefineConfig({ // ... retries: process.env.CI ? 2 : 0, // 在 CI/CD 環(huán)境下重試2次，本地不重試 // ...})

● 在 `pytest` (Python) 中：

可以利用`pytest-rerunfailures` 插件，或在 CI/CD 中配置重試邏輯。

# 命令行運(yùn)行pytest --reruns 2 --reruns-delay 1 # 失敗后重試2次，每次間隔1秒

重要：重試只是權(quán)宜之計(jì)，治標(biāo)不治本。它給你時(shí)間去定位和修復(fù)根本問題，而不是掩蓋它們。

2. 強(qiáng)大的調(diào)試與分析工具

Playwright Trace Viewer（追蹤查看器）：記錄完整的測(cè)試執(zhí)行軌跡，包括每一步的操作、網(wǎng)絡(luò)請(qǐng)求、DOM 快照、日志和失敗堆棧。這是診斷閃爍測(cè)試的終極武器。

啟用 Trace：在 `playwright.config.ts` (或 `pytest` 運(yùn)行參數(shù)) 中配置 `trace: 'on-first-retry'` 或 `trace: 'on'`。

運(yùn)行并分析：失敗后，使用 `playwright show-trace trace.zip` 命令打開分析。你可以一步步回放測(cè)試，查看每一步的 DOM 狀態(tài)和元素是否可見、可交互。

視頻錄制與截屏：失敗時(shí)自動(dòng)錄制視頻和截屏。

配置：在 `new_context()` 或 `launch()` 中配置 `record_video` 和 `screenshot` 選項(xiàng)。

# video_path 是視頻保存的目錄context = browser.new_context(record_video_dir="videos/", record_video_size={'width': 640, 'height': 480})# ...# 在測(cè)試失敗時(shí)自動(dòng)截圖 (pytest-playwright 默認(rèn)會(huì)做)# page.screenshot(path="failed_screenshot.png")

這些視覺證據(jù)對(duì)于理解非預(yù)期行為至關(guān)重要。

3. 優(yōu)化等待策略和斷言

回顧“同步等待問題”部分，確保所有的等待都是顯式且精確的。

使用Playwright的`expect`庫(kù)進(jìn)行健壯性斷言，例如`expect(locator).to_be_visible()`而不是`assert locator.is_visible()`。前者會(huì)進(jìn)行自動(dòng)等待直到條件滿足或超時(shí)。

from playwright.sync_api import expect# 斷言元素可見，Playwright 會(huì)自動(dòng)等待直到可見或超時(shí)expect(page.locator(".success-message")).to_be_visible()# 斷言元素不可見expect(page.locator(".loading-spinner")).to_be_hidden()# 斷言元素文本內(nèi)容expect(page.locator("#username-display")).to_have_text("John Doe")

4. 消除非確定性因素

獨(dú)立用例：確保每個(gè)測(cè)試用例都是獨(dú)立的，不依賴于其他用例的執(zhí)行順序或狀態(tài)。利用 Pytest 的 fixture 機(jī)制做好 `setup` 和 `teardown`。

清理會(huì)話：每次測(cè)試前，確保瀏覽器會(huì)話干凈。`context.new_page()` 默認(rèn)會(huì)提供干凈的頁(yè)面，但對(duì)于 `browser.new_context()` 要注意。

時(shí)間/隨機(jī)數(shù)：避免測(cè)試依賴于當(dāng)前時(shí)間或隨機(jī)數(shù)。如果必須，則在測(cè)試中固定或模擬它們。

三、性能與效率低下

當(dāng)測(cè)試套件變得龐大時(shí)，執(zhí)行時(shí)間過長(zhǎng)會(huì)嚴(yán)重影響反饋速度，降低自動(dòng)化測(cè)試的價(jià)值。

常見原因：

1. 測(cè)試用例冗余：大量重復(fù)或低價(jià)值的測(cè)試用例。

2. 低效的定位器：使用了過于寬泛或復(fù)雜的 XPath/CSS Selector，導(dǎo)致查找元素耗時(shí)。

3. 不必要的 UI 操作：頻繁的頁(yè)面跳轉(zhuǎn)、不必要的點(diǎn)擊和輸入。

4. 串行執(zhí)行：未充分利用多核 CPU 或分布式資源。

5. 環(huán)境性能瓶頸：測(cè)試機(jī)或被測(cè)系統(tǒng)性能不足。

Playwright 定位與解決技巧：

1. 遵循測(cè)試金字塔原則

優(yōu)先編寫單元測(cè)試和接口測(cè)試，它們速度快、成本低。

UI 自動(dòng)化測(cè)試只覆蓋關(guān)鍵業(yè)務(wù)路徑和用戶場(chǎng)景。避免對(duì)每個(gè)微小功能都進(jìn)行 UI 自動(dòng)化。

2. 優(yōu)化 Playwright 配置

無(wú)頭模式 (Headless Mode)：在 CI/CD 環(huán)境下，默認(rèn)開啟無(wú)頭模式，可以顯著提高執(zhí)行速度。

browser = playwright.chromium.launch(headless=True) # 默認(rèn)就是 True

并行執(zhí)行：Playwright Test Runner 支持多進(jìn)程并行執(zhí)行測(cè)試用例，充分利用 CPU 核心。

# 運(yùn)行所有測(cè)試，使用 4 個(gè) worker 并行pytest --workers 4

3. 利用 `context` 和 `page` 的生命周期

在 `pytest` 中，`page` fixture 默認(rèn)是 `function` scope，`browser` fixture 默認(rèn)是 `module` scope。

對(duì)于需要在相同瀏覽器上下文（例如已登錄狀態(tài)）下運(yùn)行的多個(gè)測(cè)試用例，可以考慮在 `module` 或 `class` 級(jí)別創(chuàng)建 `context`，在 `function` 級(jí)別創(chuàng)建 `page`。這樣可以避免每次測(cè)試都重新登錄或初始化上下文。

4. 最小化 UI 交互

對(duì)于只涉及數(shù)據(jù)校驗(yàn)的場(chǎng)景，優(yōu)先通過 Playwright 的 `request` context 進(jìn)行接口調(diào)用來(lái)完成數(shù)據(jù)準(zhǔn)備或驗(yàn)證，避免不必要的 UI 交互。這比 UI 操作快幾個(gè)數(shù)量級(jí)。

5. 精簡(jiǎn)定位器

避免使用過于寬泛或復(fù)雜的 XPath，尤其是以 `//` 開頭、遍歷整個(gè) DOM 樹的 XPath。優(yōu)先使用 ID、`data-test-id` 等直接且唯一的屬性。

四、系統(tǒng)性排查自動(dòng)化測(cè)試問題的通用方法論

除了針對(duì)特定問題的解決方案，掌握一套通用的問題排查方法論至關(guān)重要。

1. 觀察與收集證據(jù)

自動(dòng)化錄屏/截屏：配置 Playwright 失敗時(shí)自動(dòng)錄制視頻和截屏。

Playwright Trace Viewer：運(yùn)行失敗后，第一時(shí)間打開 Trace Viewer 回放測(cè)試，觀察每一步的 DOM 狀態(tài)、網(wǎng)絡(luò)請(qǐng)求和日志。

詳細(xì)日志：在腳本中加入詳細(xì)的日志輸出（如操作步驟、變量值、錯(cuò)誤信息），失敗時(shí)能快速定位。

瀏覽器 Console & Network：在Trace Viewer中查看瀏覽器控制臺(tái)是否有 JavaScript 錯(cuò)誤，網(wǎng)絡(luò)請(qǐng)求是否正常（HTTP狀態(tài)碼、響應(yīng)時(shí)間）。

2. 隔離與復(fù)現(xiàn)

運(yùn)行單個(gè)用例：嘗試單獨(dú)運(yùn)行失敗的測(cè)試用例，排除其他用例的干擾。

簡(jiǎn)化用例：注釋掉與失敗無(wú)關(guān)的代碼，逐步簡(jiǎn)化用例，找出最小復(fù)現(xiàn)路徑。

本地復(fù)現(xiàn)：優(yōu)先在本地環(huán)境（`--headed --debug` 模式）復(fù)現(xiàn)問題，方便交互式調(diào)試。

3. 驗(yàn)證與調(diào)試

手動(dòng)復(fù)現(xiàn)：根據(jù)失敗時(shí)的信息，手動(dòng)在瀏覽器中操作，看是否能穩(wěn)定復(fù)現(xiàn)。

逐步調(diào)試：在IDE中設(shè)置斷點(diǎn)，逐步執(zhí)行代碼，觀察變量值和元素狀態(tài)。利用 Playwright Inspector 的 Step-by-step 模式。

斷言增加：在關(guān)鍵步驟增加斷言，驗(yàn)證中間狀態(tài)是否符合預(yù)期。

4. 定位根因

● 是應(yīng)用自身的 Bug？測(cè)試數(shù)據(jù)問題？環(huán)境問題？還是自動(dòng)化腳本（定位器、等待、邏輯）的問題？

● 與開發(fā)團(tuán)隊(duì)溝通，了解最近的代碼變更，是否有影響到被測(cè)功能。

5. 修復(fù)與驗(yàn)證

修復(fù)代碼：針對(duì)定位到的問題，修改自動(dòng)化腳本或聯(lián)系開發(fā)修復(fù)應(yīng)用 Bug。

驗(yàn)證修復(fù)：運(yùn)行失敗的用例，確保問題已解決，并考慮增加新的斷言或用例來(lái)防止類似問題再次發(fā)生。

6. 文檔化與分享

● 將排查過程、根因分析和解決方案記錄下來(lái)，形成知識(shí)庫(kù)。

●在團(tuán)隊(duì)內(nèi)部進(jìn)行分享，提升團(tuán)隊(duì)整體的排查能力和避免踩坑。

總結(jié)

每一次失敗都是一次學(xué)習(xí)的機(jī)會(huì)，每一次排查都是一次自我提升。希望這篇指南能幫助大家在 Web 自動(dòng)化測(cè)試的道路上披荊斬棘，所向披靡！

??想了解更多漲薪技能提升方法

??可以到公主號(hào)【Atstudy技術(shù)社區(qū)】,即可加入領(lǐng)取 ??????

轉(zhuǎn)行、入門、提升、需要的各種干貨資料

內(nèi)含AI測(cè)試、 車載測(cè)試、AI大模型開發(fā)、BI數(shù)據(jù)分析、銀行測(cè)試、游戲測(cè)試、AIGC