← 所有文章

工程 · 2026.10.10 · 4 min

對整個前端跑一次 code review:七十幾筆 finding 裡最有教訓的四類

用 Claude Code 對 EZLO 前端跑完整 review,確認七十幾筆問題。這篇挑出最有教訓價值的四類,加上測試要在未修正版上失敗的驗收規則,以及跨瀏覽器測試的結果。

閱讀設定
主題
字級
寬度

我用 Claude Code 的 /code-review max 對 EZLO 整個前端跑了一次 review,確認屬實的有七十幾筆,大多是操作送錯或狀態畫錯,例如確認框按的是「暫停」,送出去的卻是恢復。全部修完之後回頭看,同類的問題很多,最有教訓價值的是四類。驗收上最重要的一條規則是:每筆修正的測試,都要在未修正的 build 上失敗。跨瀏覽器矩陣跑了近三千個測試,真的平台差異只抓到一個。

驗收規則

開始修之前先定規則。每一筆先對照 code 確認屬實才修,不屬實的寫明原因。每一筆都要有測試,而且同一個測試在未修正的 build 上要會失敗。測試在未修正版上也會過,就證明不了修正有效。

流程圖:每一筆 finding 先對照 code 確認屬實,不屬實就不修並寫明原因;屬實就修正並加測試,同一個測試要在未修正的 build 上失敗才算驗收,在未修正版上也會過就證明不了修正有效。

最有教訓價值的四類問題

第一類是文案和後端行為對不上。這時要先確認哪一邊才是設計上要的。停權的文案說帳號停權後 Bot 會停,後端其實沒停。被停權的人登不進來,營運端也沒有 UI 能代為暫停,Bot 繼續掛單就沒有任何人停得了,所以這筆改後端:引擎取名單時排除停權的使用者,在途的掛單沿用既有的撤單排程撤掉,使用者自己的放貸開關不動。反過來,維護頁寫著維護期間 Bot 暫停掛新單,但設計文件明寫維護不停引擎,那筆就改文案。

第二類是把暫時性的失敗當成永久的。refresh 遇到 5xx 就把人登出,促銷 API 失敗就當作沒有活動。refresh 改成只有後端明確拒絕(400、401、403)才算 session 失效;429、5xx、網路錯誤丟出 refresh 自己的錯誤,不沿用原請求的 401 或 403,因為 layout 看到這兩個 status 會自己把人導去首頁。

第三類是把「不知道」畫成別的狀態。缺資料畫成 0,被停權顯示成「自己暫停」。停權那筆我沒有加新的狀態值,仍然是 paused,成因另外由一個函式推導,Topbar 不用改就安全,也跟後台用的狀態維持同一組字。

第四類是狀態改變了,相關設定卻要等使用者操作才跟上。換了金鑰之後,放貸設定還綁著舊金鑰,狀態顯示運轉中,實際一張單都不掛。改綁放在金鑰狀態改變的當下做:新增金鑰時、健康檢查停用金鑰時,後端直接把設定接到啟用中的金鑰。只靠使用者去放貸頁按儲存不夠,表單沒有改動時,連儲存鍵都不會出現。

四類問題:文案和後端行為對不上,先確認哪邊是設計要的,停權改後端、維護改文案;暫時失敗當成永久,改成後端明確拒絕(400、401、403)才算 session 失效;「不知道」畫成別的狀態,狀態值不變、成因另外推導;狀態變了設定沒跟上,金鑰狀態改變的當下後端就改綁。

跨瀏覽器測試

Playwright 開了 10 個平台設定檔,涵蓋 Chrome、WebKit、Firefox 的桌機與手機。真瀏覽器用 iOS 模擬器的 Safari、Android 模擬器的 Chrome,以及 Mac 本機的 Safari 和 Chrome。Windows 沒有真機,只有引擎加 Windows UA 的模擬。

抓到的真問題只有一個:註冊時用 Accept-Language header 帶介面語言,在 Firefox 和 WebKit 上無效,頁面自己設的值到不了後端。改成放在 request body,後端加一個 language 欄位,沒帶才退回看 header。

其餘的平台差異,都是測試本身的假設有問題。有一個要特別記:Playwright 在 WebKit 和 Firefox 模擬 locale 時,會在網路層蓋掉 Accept-Language,header 的斷言在這兩個引擎上不可信,要改看後端存下來的值。

最後在 main 上跑完整矩陣,2936 個通過、44 個失敗。其中 30 個是 Turnstile 的測試缺對應的 build,補上後全過,另外 14 個是單一平台的偶發失敗,重跑全過。

堆疊長條圖:Playwright 10 個平台設定檔在 main 上跑完整矩陣,2936 個通過、44 個失敗;44 個失敗裡 30 個是 Turnstile 測試缺對應的 build,補上後全過,14 個是單一平台的偶發失敗,重跑全過。

平行 agent 撐爆機器

修正拆成多個 PR,交給平行的 agent,各自一個 worktree。agent 不 commit,由主 session review diff 後統一 commit,整合前每一行都看得到。

第二批是 15 個 PR,這台 16GB 的 Mac 撐不住了。八個 agent 同時跑讓 session 重啟一次,所有 agent 一起中斷,好在修改都留在各自的 worktree,大部分直接 review 收尾。之後固定同時最多兩件事:一個 agent 加我自己的 build 或測試,或兩個 agent 而我只做不吃資源的事。

小結

  • AI 跑出來的 finding,每一筆先對 code 確認,不屬實的寫明原因。
  • 修 bug 的測試要在未修正版上失敗,不然證明不了任何事。
  • 文案和後端行為對不上時,先確認哪一邊才是設計上要的。
  • 「不知道」不要畫成 0,暫時失敗不要當成永久失敗。
  • 平行開 agent 之前,先算一下機器撐不撐得住。
#前端#Playwright#Code Review#跨瀏覽器測試

留言

載入留言中…

下一篇

工具

教學文章配圖:插畫交給生圖模型,有字的圖用 HTML 畫

EZLO 教學區 16 篇原本只有文字。封面用生圖模型加合成腳本統一風格,有字的示意圖改用 HTML 排版再截圖,圖上的數字一律對回公開資料。