1. 當(dāng)“e2e”不再只是三個(gè)字母從熱詞到落地場(chǎng)景的拆解第一次看到“e2e”這個(gè)詞很多人腦子里蹦出來(lái)的可能是“端到端”三個(gè)字然后就沒(méi)有然后了。但如果你最近在技術(shù)社區(qū)、產(chǎn)品群或者招聘 JD 里頻繁刷到它尤其是“e2e profile1”這種組合詞開(kāi)始冒頭那就說(shuō)明一件事端到端測(cè)試與端到端流程驗(yàn)證正在從“大廠專(zhuān)屬”變成“團(tuán)隊(duì)標(biāo)配”。我做了十多年一線項(xiàng)目從最早手工點(diǎn)頁(yè)面到后來(lái)寫(xiě)腳本跑回歸再到現(xiàn)在把 e2e 當(dāng)成發(fā)布流水線的守門(mén)員踩過(guò)的坑比跑通的用例還多。這篇文章不打算給你背教科書(shū)而是把“e2e”這個(gè)標(biāo)題背后真正值得聊的東西——它到底測(cè)什么、為什么總在 CI 里掛、profile1 這種配置到底在配什么、以及怎么讓 e2e 從“拖后腿的”變成“真能兜底的”——一次性講透。先給剛接觸的朋友一個(gè)最直白的定義e2eend-to-end指的是從用戶(hù)視角出發(fā)把整個(gè)系統(tǒng)當(dāng)成一個(gè)黑盒驗(yàn)證一條完整業(yè)務(wù)鏈路是否能跑通。比如“用戶(hù)登錄→搜索商品→加入購(gòu)物車(chē)→下單→支付成功→收到訂單確認(rèn)”這一整條走完才叫一個(gè) e2e 用例。它和單元測(cè)試、集成測(cè)試最大的區(qū)別在于單元測(cè)試盯著一個(gè)函數(shù)集成測(cè)試盯著幾個(gè)模塊而 e2e 盯著“用戶(hù)能不能把事辦成”。這也是為什么 e2e 一旦失敗往往不是某個(gè)函數(shù)寫(xiě)錯(cuò)了而是環(huán)境、數(shù)據(jù)、網(wǎng)絡(luò)、第三方服務(wù)、甚至?xí)r間戳格式對(duì)不上——排查起來(lái)特別像破案。那“e2e profile1”又是什么結(jié)合社區(qū)里常見(jiàn)的用法profile 通常指的是一套環(huán)境配置檔案。你可以把它理解成“給 e2e 跑測(cè)時(shí)用哪套參數(shù)、連哪個(gè)庫(kù)、走哪個(gè)網(wǎng)關(guān)、開(kāi)哪些開(kāi)關(guān)”的集合。profile1 往往是默認(rèn)檔案或者基礎(chǔ)檔案比如指向測(cè)試環(huán)境、使用 mock 支付、關(guān)閉短信真實(shí)發(fā)送。很多團(tuán)隊(duì)一開(kāi)始不重視 profile 管理所有環(huán)境共用一套配置結(jié)果本地跑得好好的一到 CI 就大面積飄紅。所以這篇文章會(huì)圍繞“e2e 到底怎么落地”展開(kāi)重點(diǎn)講清楚 profile 配置、用例設(shè)計(jì)、穩(wěn)定性治理和 CI 集成這幾塊硬骨頭。適合誰(shuí)看測(cè)試開(kāi)發(fā)、前端/后端想補(bǔ)測(cè)試短板的工程師、技術(shù)負(fù)責(zé)人以及被 e2e 不穩(wěn)定折磨到想砸鍵盤(pán)的人。2. e2e 用例到底該覆蓋什么從“點(diǎn)得動(dòng)”到“業(yè)務(wù)閉環(huán)”2.1 先分清冒煙、回歸與全鏈路別把 e2e 當(dāng)萬(wàn)能筐很多團(tuán)隊(duì)一上來(lái)就寫(xiě)幾十條 e2e恨不得把每個(gè)按鈕都點(diǎn)一遍結(jié)果維護(hù)成本爆炸跑一次半小時(shí)最后大家都不看結(jié)果。我的經(jīng)驗(yàn)是e2e 要分層不是所有場(chǎng)景都配叫端到端。通常我會(huì)把 e2e 分成三類(lèi)冒煙級(jí)、回歸級(jí)、全鏈路級(jí)。冒煙級(jí)只跑最核心的 3 到 5 條比如登錄、首頁(yè)加載、核心下單入口目的是“系統(tǒng)還活著”回歸級(jí)覆蓋主要業(yè)務(wù)分支比如不同支付方式、優(yōu)惠券疊加、退款流程目的是“改動(dòng)能沒(méi)把老功能弄壞”全鏈路級(jí)則涉及跨系統(tǒng)比如訂單創(chuàng)建后觸發(fā)庫(kù)存扣減、物流單生成、消息通知目的是“上下游對(duì)得上”。為什么要這么分因?yàn)?e2e 的執(zhí)行成本遠(yuǎn)高于單元測(cè)試。一條 e2e 用例從啟動(dòng)瀏覽器、準(zhǔn)備數(shù)據(jù)、執(zhí)行操作到斷言清理動(dòng)輒幾十秒。如果你把 200 條 e2e 塞進(jìn)每次提交開(kāi)發(fā)者等結(jié)果的時(shí)間比寫(xiě)代碼還長(zhǎng)最后必然被繞過(guò)。我見(jiàn)過(guò)一個(gè)團(tuán)隊(duì)CI 里掛了 180 條 e2e平均耗時(shí) 42 分鐘結(jié)果大家養(yǎng)成了“先合并再說(shuō)e2e 紅了明天看”的習(xí)慣那這套 e2e 就形同虛設(shè)。后來(lái)他們砍到 28 條核心回歸耗時(shí)降到 6 分鐘反而每次紅都能被認(rèn)真對(duì)待。所以第一原則e2e 用例數(shù)量要克制覆蓋要精準(zhǔn)寧可少而穩(wěn)不要多而飄。具體怎么選我通常用“業(yè)務(wù)價(jià)值 × 變更頻率”來(lái)篩。業(yè)務(wù)價(jià)值高、變更頻率也高的模塊比如購(gòu)物車(chē)、結(jié)算頁(yè)必須進(jìn)回歸業(yè)務(wù)價(jià)值高但很少改的比如登錄進(jìn)冒煙即可業(yè)務(wù)價(jià)值低又常改的比如某個(gè)活動(dòng)彈窗樣式交給組件測(cè)試或視覺(jué)回歸別塞進(jìn) e2e。這個(gè)篩選過(guò)程最好和產(chǎn)品、開(kāi)發(fā)一起過(guò)一遍避免測(cè)試單方面拍腦袋。2.2 一條合格 e2e 用例的骨架準(zhǔn)備、執(zhí)行、斷言、清理寫(xiě) e2e 最怕的就是“只寫(xiě)操作不寫(xiě)清理”跑完一次數(shù)據(jù)庫(kù)里多一堆臟數(shù)據(jù)第二次跑就沖突。我習(xí)慣把每條用例拆成四段前置準(zhǔn)備setup、用戶(hù)操作action、結(jié)果斷言assert、環(huán)境清理teardown。前置準(zhǔn)備不只是打開(kāi)頁(yè)面還包括造數(shù)據(jù)——比如創(chuàng)建一個(gè)專(zhuān)用測(cè)試賬號(hào)、往購(gòu)物車(chē)塞一件指定商品、把庫(kù)存調(diào)到已知值。這里有個(gè)關(guān)鍵技巧盡量用 API 造數(shù)據(jù)而不是用 UI 造數(shù)據(jù)。因?yàn)?UI 造數(shù)據(jù)慢且不穩(wěn)定一個(gè)下拉框加載失敗就卡住而 API 造數(shù)據(jù)快、可復(fù)用、失敗原因清晰。執(zhí)行階段要模擬真實(shí)用戶(hù)行為但不要過(guò)度模擬。比如點(diǎn)擊按鈕用框架提供的 click 即可不需要模擬鼠標(biāo)移動(dòng)軌跡。斷言階段是重點(diǎn)不要只斷言“頁(yè)面跳轉(zhuǎn)了”要斷言“業(yè)務(wù)狀態(tài)正確”。比如下單成功除了看跳轉(zhuǎn)到訂單頁(yè)還要查訂單狀態(tài)是否為“待發(fā)貨”、庫(kù)存是否扣減、優(yōu)惠券是否核銷(xiāo)。很多 bug 就藏在“頁(yè)面看起來(lái)對(duì)了但數(shù)據(jù)沒(méi)落庫(kù)”里。清理階段則要?jiǎng)h掉測(cè)試訂單、恢復(fù)庫(kù)存、注銷(xiāo)賬號(hào)保證下次跑不受影響。如果清理失敗要有日志記錄否則臟數(shù)據(jù)會(huì)越積越多。提示teardown 里不要做太復(fù)雜的邏輯否則清理本身也會(huì)失敗。簡(jiǎn)單直接地按 ID 刪除比“先查再刪再校驗(yàn)”更穩(wěn)。2.3 斷言的藝術(shù)別讓 e2e 變成“截圖對(duì)比器”我見(jiàn)過(guò)不少 e2e 用例斷言寫(xiě)得特別虛expect(page).toHaveTitle(首頁(yè))或者expect(element).toBeVisible()。這種斷言只能證明“頁(yè)面沒(méi)崩”證明不了“業(yè)務(wù)對(duì)”。真正有價(jià)值的斷言應(yīng)該落在數(shù)據(jù)層和狀態(tài)層。比如支付成功后我會(huì)同時(shí)斷言頁(yè)面出現(xiàn)“支付成功”文案、訂單接口返回的 status 為 PAID、數(shù)據(jù)庫(kù)里該訂單的支付時(shí)間不為空、賬戶(hù)余額扣減了正確金額。這樣即使 UI 改版只要業(yè)務(wù)邏輯沒(méi)壞用例依然能過(guò)反過(guò)來(lái)如果 UI 沒(méi)變但數(shù)據(jù)錯(cuò)了也能立刻發(fā)現(xiàn)。另一個(gè)坑是“等待時(shí)間寫(xiě)死”。sleep(3000)是 e2e 穩(wěn)定性的頭號(hào)殺手。網(wǎng)絡(luò)快的時(shí)候浪費(fèi) 3 秒網(wǎng)絡(luò)慢的時(shí)候 3 秒不夠直接失敗。正確做法是用條件等待等某個(gè)元素出現(xiàn)、等某個(gè)接口返回、等某個(gè)狀態(tài)變?yōu)?true。主流框架都支持顯式等待比如 Playwright 的waitForResponse、Cypress 的intercept。我通常會(huì)給等待設(shè)一個(gè)上限比如 10 秒超過(guò)就失敗并打印當(dāng)前頁(yè)面快照和網(wǎng)絡(luò)日志方便定位。3. e2e profile1 配置詳解環(huán)境、數(shù)據(jù)與開(kāi)關(guān)的三角關(guān)系3.1 profile 到底在配什么一張表看清核心字段“e2e profile1”這個(gè)說(shuō)法不同團(tuán)隊(duì)實(shí)現(xiàn)不一樣但核心離不開(kāi)三類(lèi)配置環(huán)境地址、測(cè)試數(shù)據(jù)策略、功能開(kāi)關(guān)。我拿一個(gè)典型的前端 e2e 項(xiàng)目舉例profile1 通常長(zhǎng)這樣配置項(xiàng)示例值作用常見(jiàn)坑baseUrlhttps://test.example.com被測(cè)系統(tǒng)入口寫(xiě)成生產(chǎn)地址導(dǎo)致臟數(shù)據(jù)apiBaseUrlhttps://test-api.example.com接口請(qǐng)求前綴和前端代理不一致導(dǎo)致 404testUsere2e_user_01 / 固定密碼登錄賬號(hào)多人共用導(dǎo)致并發(fā)沖突paymentModemock支付方式誤用真實(shí)支付產(chǎn)生資金流水smsEnabledfalse短信開(kāi)關(guān)開(kāi)啟后瘋狂發(fā)短信dbConnectiontest_db_connection_string數(shù)據(jù)庫(kù)校驗(yàn)連到生產(chǎn)庫(kù)直接完蛋retryTimes2失敗重試次數(shù)設(shè)太高掩蓋真實(shí) bug這張表里的每一項(xiàng)都是我用血淚換來(lái)的。比如baseUrl寫(xiě)錯(cuò)曾經(jīng)有同事把 profile 指向了預(yù)發(fā)環(huán)境結(jié)果 e2e 跑完在預(yù)發(fā)庫(kù)留下一堆測(cè)試訂單第二天運(yùn)營(yíng)對(duì)數(shù)據(jù)對(duì)到崩潰。再比如testUser共用兩個(gè)人同時(shí)跑 CI一個(gè)把另一個(gè)的購(gòu)物車(chē)清空了用例隨機(jī)失敗查了半天以為是并發(fā) bug其實(shí)是賬號(hào)沖突。所以 profile 管理的第一原則環(huán)境隔離要徹底測(cè)試賬號(hào)要獨(dú)占危險(xiǎn)開(kāi)關(guān)默認(rèn)關(guān)閉。3.2 多 profile 切換本地、CI、預(yù)發(fā)各用各的一個(gè)健康的 e2e 項(xiàng)目至少要有三個(gè) profilelocal、ci、staging。本地開(kāi)發(fā)時(shí)用 local連本地起的服務(wù)數(shù)據(jù)庫(kù)用內(nèi)存庫(kù)或者 Docker 容器跑得快、隨便造CI 上用 ci連獨(dú)立的測(cè)試環(huán)境數(shù)據(jù)每次重置保證可重復(fù)預(yù)發(fā)驗(yàn)證用 staging連預(yù)發(fā)環(huán)境但只跑冒煙級(jí)用例避免污染。切換方式通?？凯h(huán)境變量比如E2E_PROFILEci npm run e2e代碼里根據(jù)變量加載對(duì)應(yīng)配置文件。這里有個(gè)容易忽略的點(diǎn)profile 文件不要提交敏感信息。數(shù)據(jù)庫(kù)密碼、第三方 key 這些應(yīng)該通過(guò) CI 的 secret 注入而不是硬編碼在倉(cāng)庫(kù)里。我見(jiàn)過(guò)一個(gè)開(kāi)源項(xiàng)目profile 里直接寫(xiě)了測(cè)試庫(kù)的 root 密碼雖然說(shuō)是測(cè)試庫(kù)但也是安全隱患。正確做法是 profile 文件只放非敏感默認(rèn)值敏感項(xiàng)用環(huán)境變量覆蓋代碼里做兜底讀取。3.3 數(shù)據(jù)準(zhǔn)備與清理profile 里的隱藏重頭戲profile 不只是配地址還要配“數(shù)據(jù)怎么來(lái)、怎么走”。我通常會(huì)在 profile 里定義幾個(gè)數(shù)據(jù)策略seed預(yù)置數(shù)據(jù)、cleanup清理策略、isolation隔離級(jí)別。比如 ci profile 用seed: minimal只造一條必須的測(cè)試商品和賬號(hào)local profile 用seed: full造一批方便調(diào)試staging profile 用cleanup: none因?yàn)轭A(yù)發(fā)環(huán)境不允許隨便刪數(shù)據(jù)改用唯一標(biāo)識(shí)前綴來(lái)區(qū)分測(cè)試數(shù)據(jù)。清理策略尤其重要。如果每次跑完不清理測(cè)試庫(kù)會(huì)越來(lái)越臃腫查詢(xún)變慢甚至觸發(fā)唯一約束沖突。我的做法是每條用例生成一個(gè)唯一 runId所有造的數(shù)據(jù)都帶上這個(gè) runId 前綴teardown 時(shí)按前綴批量刪除。這樣即使清理失敗也能通過(guò)定時(shí)任務(wù)掃掉過(guò)期 runId 的數(shù)據(jù)。這個(gè)技巧在訂單、優(yōu)惠券這類(lèi)容易沖突的業(yè)務(wù)里特別管用。4. 讓 e2e 不再“玄學(xué)失敗”穩(wěn)定性治理的五個(gè)抓手4.1 失敗重試不是萬(wàn)能藥先分清“真 bug”和“環(huán)境抖動(dòng)”e2e 最讓人崩潰的就是“這次失敗下次過(guò)”。很多人第一反應(yīng)是加重試重試兩次還失敗才報(bào)錯(cuò)。但重試是把雙刃劍它確實(shí)能過(guò)濾掉網(wǎng)絡(luò)抖動(dòng)、偶發(fā)超時(shí)但也會(huì)掩蓋真正的并發(fā) bug 和資源泄漏。我的原則是重試只用于基礎(chǔ)設(shè)施層面的抖動(dòng)不用于業(yè)務(wù)斷言失敗。比如“等待元素超時(shí)”可以重試“訂單金額不對(duì)”絕對(duì)不能重試必須立刻失敗并報(bào)警。怎么區(qū)分我會(huì)在用例里給失敗打標(biāo)簽。框架通常支持自定義錯(cuò)誤類(lèi)型我把超時(shí)、連接拒絕、DNS 解析失敗歸為INFRA把斷言失敗、元素找不到歸為BUSINESS。CI 里只對(duì)INFRA自動(dòng)重試BUSINESS直接紅。這樣既減少了誤報(bào)又不會(huì)放過(guò)真問(wèn)題。另外重試次數(shù)不要超過(guò) 2重試間隔要有退避比如第一次等 1 秒第二次等 3 秒避免瞬間打爆被測(cè)服務(wù)。4.2 等待策略從 sleep 到智能等待的進(jìn)化前面提過(guò) sleep 的危害這里展開(kāi)講怎么替代。以 Playwright 為例它內(nèi)置了自動(dòng)等待點(diǎn)擊元素前會(huì)等元素可交互導(dǎo)航后會(huì)等頁(yè)面加載。但自動(dòng)等待不是萬(wàn)能的涉及接口異步返回時(shí)還是要顯式等待。我常用的模式是先等接口響應(yīng)再等 UI 更新最后斷言數(shù)據(jù)。比如下單場(chǎng)景先waitForResponse(/api/order/create)拿到響應(yīng)后解析 orderId再等頁(yè)面出現(xiàn)訂單號(hào)最后用 orderId 查數(shù)據(jù)庫(kù)確認(rèn)狀態(tài)。對(duì)于輪詢(xún)類(lèi)場(chǎng)景比如“支付后訂單狀態(tài)變?yōu)橐阎Ц丁辈灰霉潭ㄩg隔死等而是用expect.poll或自己寫(xiě)一個(gè)帶超時(shí)的輪詢(xún)函數(shù)每 500 毫秒查一次最多查 20 次。這樣既快又穩(wěn)。還有一個(gè)細(xì)節(jié)等待超時(shí)時(shí)間要可配置不同環(huán)境網(wǎng)絡(luò)狀況不同ci 環(huán)境可以設(shè)長(zhǎng)一點(diǎn)local 設(shè)短一點(diǎn)通過(guò) profile 控制。4.3 測(cè)試數(shù)據(jù)隔離別讓用例之間互相“打架”e2e 用例并行跑的時(shí)候數(shù)據(jù)沖突是頭號(hào)殺手。A 用例在改購(gòu)物車(chē)B 用例在清購(gòu)物車(chē)結(jié)果兩個(gè)都失敗。解決辦法有三個(gè)層次賬號(hào)隔離、數(shù)據(jù)隔離、時(shí)間隔離。賬號(hào)隔離最簡(jiǎn)單每個(gè)并行 worker 用不同測(cè)試賬號(hào)通過(guò) profile 里的賬號(hào)池分配。數(shù)據(jù)隔離是給每條用例造獨(dú)立數(shù)據(jù)比如每個(gè)用例創(chuàng)建一個(gè)專(zhuān)屬商品用完刪除。時(shí)間隔離則是錯(cuò)開(kāi)執(zhí)行但會(huì)拖慢速度一般不推薦。我實(shí)際項(xiàng)目里用的是“賬號(hào)池 runId 前綴”組合。CI 啟動(dòng)時(shí)生成一個(gè)全局 runId每個(gè) worker 從賬號(hào)池領(lǐng)一個(gè)賬號(hào)所有造的數(shù)據(jù)都帶runId_workerId前綴。這樣即使兩個(gè) worker 同時(shí)跑數(shù)據(jù)也不會(huì)串。清理時(shí)按 runId 批量刪干凈利落。這個(gè)方案在 8 個(gè)并行 worker 下跑了半年沒(méi)出現(xiàn)過(guò)數(shù)據(jù)沖突。4.4 失敗現(xiàn)場(chǎng)保留截圖、視頻、網(wǎng)絡(luò)日志一個(gè)都不能少e2e 失敗后最痛苦的是“不知道為什么失敗”。如果 CI 只告訴你“元素沒(méi)找到”你根本沒(méi)法復(fù)現(xiàn)。所以失敗現(xiàn)場(chǎng)保留是必須的。我通常配置三樣失敗時(shí)自動(dòng)截圖、錄制視頻、保存網(wǎng)絡(luò)請(qǐng)求日志HAR 文件。截圖看 UI 狀態(tài)視頻看操作過(guò)程HAR 看接口返回。這三樣結(jié)合起來(lái)90% 的失敗都能直接定位。存儲(chǔ)策略也要注意不要把所有運(yùn)行的視頻都存下來(lái)太占空間。只存失敗用例的并且設(shè)置過(guò)期時(shí)間比如 7 天自動(dòng)清理。CI 里可以把這些附件上傳到制品庫(kù)方便點(diǎn)開(kāi)查看。另外控制臺(tái)日志也要保留尤其是瀏覽器 console 的 error 和 warn很多前端報(bào)錯(cuò)就藏在那里。4.5 用例分級(jí)與執(zhí)行策略把好鋼用在刀刃上最后一點(diǎn)是執(zhí)行策略。不是所有 e2e 都要在每次提交時(shí)跑。我的做法是提交時(shí)只跑冒煙級(jí)3 到 5 條合并到主分支跑回歸級(jí)20 到 30 條每晚跑全鏈路級(jí)50 條以上。這樣既保證了快速反饋又保證了深度覆蓋。CI 配置里用不同的 npm script 區(qū)分比如test:e2e:smoke、test:e2e:regression、test:e2e:full。另外對(duì)于頻繁變更的模塊可以加“定向觸發(fā)”當(dāng) PR 改動(dòng)了結(jié)算頁(yè)代碼自動(dòng)觸發(fā)結(jié)算相關(guān)的 e2e 子集。這需要結(jié)合代碼變更分析稍微復(fù)雜但收益很大。我見(jiàn)過(guò)一個(gè)團(tuán)隊(duì)用這個(gè)策略把 e2e 反饋時(shí)間從 20 分鐘壓到 4 分鐘開(kāi)發(fā)者體驗(yàn)直線上升。5. 從零搭一套 e2e 流水線我的實(shí)操步驟與踩坑記錄5.1 選型Playwright、Cypress 還是 Selenium選型沒(méi)有絕對(duì)好壞只有適不適合。我列個(gè)對(duì)比表基于我實(shí)際用過(guò)的感受維度PlaywrightCypressSelenium上手速度快很快慢多瀏覽器原生支持有限支持廣并行執(zhí)行內(nèi)置需付費(fèi)/插件需 Grid自動(dòng)等待強(qiáng)強(qiáng)弱調(diào)試體驗(yàn)好極好一般社區(qū)生態(tài)增長(zhǎng)快成熟最成熟我的建議新項(xiàng)目直接上 Playwright尤其是需要多瀏覽器、多語(yǔ)言、并行執(zhí)行的場(chǎng)景如果團(tuán)隊(duì)前端為主、只測(cè) Chrome、追求開(kāi)發(fā)體驗(yàn)Cypress 很舒服Selenium 適合維護(hù)老項(xiàng)目或者有特殊瀏覽器需求。profile1 這種配置在 Playwright 里對(duì)應(yīng)playwright.config.ts的 projects 配置可以按瀏覽器、按環(huán)境分 project很靈活。5.2 目錄結(jié)構(gòu)與配置讓新人也能快速上手我習(xí)慣的目錄結(jié)構(gòu)是這樣的e2e/ profiles/ local.json ci.json staging.json fixtures/ user.json product.json specs/ smoke/ regression/ full/ utils/ api.ts db.ts wait.ts playwright.config.tsprofiles放環(huán)境配置fixtures放測(cè)試數(shù)據(jù)模板specs按級(jí)別分目錄utils放公共方法。新人進(jìn)來(lái)先看 README知道怎么切 profile、怎么跑冒煙、怎么造數(shù)據(jù)。配置文件里用環(huán)境變量讀取 profile 名默認(rèn) localCI 里通過(guò) pipeline 變量覆蓋。這樣本地和 CI 行為一致減少“我本地能跑”的扯皮。5.3 CI 集成從手動(dòng)觸發(fā)到自動(dòng)門(mén)禁CI 集成我走過(guò)三個(gè)階段最早是手動(dòng)點(diǎn)按鈕跑后來(lái)是每次提交自動(dòng)跑現(xiàn)在是“冒煙自動(dòng) 回歸定時(shí) 全鏈路每晚”。GitHub Actions 的配置大概長(zhǎng)這樣name: e2e on: push: branches: [main] pull_request: jobs: smoke: runs-on: ubuntu-latest steps: - uses: actions/checkoutv4 - uses: actions/setup-nodev4 - run: npm ci - run: npx playwright install --with-deps - run: E2E_PROFILEci npm run test:e2e:smoke - uses: actions/upload-artifactv4 if: failure() with: name: e2e-artifacts path: e2e/artifacts/關(guān)鍵點(diǎn)失敗時(shí)上傳附件方便排查用E2E_PROFILEci確保環(huán)境正確playwright install要裝依賴(lài)否則瀏覽器起不來(lái)。踩過(guò)的坑CI 機(jī)器沒(méi)有中文字體截圖全是方塊后來(lái)在 Dockerfile 里加了字體包還有時(shí)區(qū)問(wèn)題CI 默認(rèn) UTC業(yè)務(wù)代碼用本地時(shí)間導(dǎo)致日期斷言失敗后來(lái)統(tǒng)一在 profile 里設(shè)TZAsia/Shanghai。5.4 常見(jiàn)失敗排查鏈路一次真實(shí)的“訂單金額不對(duì)”破案過(guò)程說(shuō)個(gè)真實(shí)案例。某天 CI 上一條下單用例失敗斷言“訂單金額等于商品價(jià)格減優(yōu)惠券”實(shí)際金額多了 10 塊。排查過(guò)程先看截圖頁(yè)面顯示優(yōu)惠券已勾選再看 HAR發(fā)現(xiàn)優(yōu)惠券接口返回了available: true但下單接口請(qǐng)求里沒(méi)帶優(yōu)惠券 ID查代碼發(fā)現(xiàn)前端在勾選優(yōu)惠券后有個(gè)防抖e2e 點(diǎn)得太快防抖還沒(méi)觸發(fā)就點(diǎn)了提交。解決方案在點(diǎn)擊優(yōu)惠券后等待“優(yōu)惠金額”文案出現(xiàn)再提交。這個(gè)案例說(shuō)明e2e 失敗不一定是后端 bug前端交互時(shí)序問(wèn)題很常見(jiàn)。排查時(shí)按“截圖→網(wǎng)絡(luò)→控制臺(tái)→代碼”的順序走效率最高。另一個(gè)常見(jiàn)失敗是“元素找不到”原因可能是頁(yè)面還沒(méi)加載完、元素在 iframe 里、元素被遮擋、選擇器寫(xiě)得太具體。我的經(jīng)驗(yàn)是選擇器優(yōu)先用>