排查前的準備:先區分「網頁版」與「桌面版」的錯誤來源
在開始六步排查之前,必須先確認你遇到的問題是發生在瀏覽器中的 web.whatsapp.com,還是安裝在作業系統上的桌面應用程式。兩者的錯誤日誌位置、快取路徑與網路行為不同,混用排查步驟會浪費時間。網頁版完全依賴瀏覽器的儲存空間(IndexedDB、LocalStorage、Service Worker)與單一分頁的生命週期;桌面版則有獨立的程序與更新機制。多數情況下,使用者回報的「一直轉圈」發生在網頁版,因為桌面版較少出現 Service Worker 註冊失敗。
請先打開瀏覽器的開發者工具(Windows/Linux 按 F12 或 Ctrl+Shift+I,macOS 按 Cmd+Option+I),切換到 Console 面板並清空既有訊息,然後重新整理頁面。觀察是否出現以下關鍵字:Failed to register a ServiceWorker、QuotaExceededError、net::ERR_CERT_AUTHORITY_INVALID、WebSocket connection to 'wss://web.whatsapp.com/ws' failed。這些訊息直接對應到後續步驟的判斷依據,比反覆重開分頁有效。
瀏覽器儲存空間與 Service Worker 的隱性故障
WhatsApp 網頁版在首次載入時會註冊 Service Worker 並建立約 50MB 至 200MB 的 IndexedDB 資料庫(實際大小隨聊天記錄與媒體快取增長)。當瀏覽器可用儲存空間低於某個閾值,或使用者曾手動清除「網站資料」但未完整移除 Service Worker,就會出現載入卡在 QR 掃描畫面、或掃描後空白的情況。Chrome 與 Edge 可在 chrome://serviceworker-internals 或 edge://serviceworker-internals 檢查註冊狀態;若看到 REDUNDANT 或 ACTIVATING 卡住超過 30 秒,表示註冊流程異常。
處理方式不是只按 Ctrl+F5,而是依序執行:開啟站點設定(網址列左側鎖頭圖示 → 網站設定),將「儲存空間」與「通知」重設為預設,再到 chrome://settings/content/all 搜尋 web.whatsapp.com 並完全刪除資料。完成後關閉所有 WhatsApp 網頁版分頁,重新開啟一個新分頁載入。若問題仍存在,檢查瀏覽器是否啟用了「關閉瀏覽器時清除 Cookie 與網站資料」;這個選項會讓 Service Worker 每次啟動都失效,是開發者環境常見的誤設定。
網路層與 WebSocket 連線的判斷依據
WhatsApp 網頁版維持連線主要依賴 WebSocket(wss://web.whatsapp.com/ws)與長輪詢備援。當企業防火牆或代理伺服器攔截 WebSocket 升級請求,頁面會顯示「正在連線」並反覆重試,Console 出現 1006 或 1015 關閉碼。此時可在開發者工具的 Network 面板篩選 WS,觀察連線是否停留在 Pending 或每隔數秒重新建立。若公司網路使用 TLS 檢查(SSL Inspection),憑證鏈可能被替換,導致 ERR_CERT_AUTHORITY_INVALID;這不是 WhatsApp 的錯誤,而是中間人憑證未被瀏覽器信任。
一般家用網路可先切換到行動熱點測試,若熱點下正常,問題多半在路由器或 ISP 的 DNS 解析。可將 DNS 改為 1.1.1.1 或 8.8.8.8 後重試,並在命令列執行 nslookup web.whatsapp.com 確認解析結果不是 0.0.0.0 或內部黑洞位址。多數情況下,WebSocket 被阻擋的症狀是「QR 碼可以顯示,但掃描後無法同步訊息」,這與完全載入失敗不同,排查方向應優先放在 Proxy 與防火牆規則。
通知不響與檔案傳輸失敗的常見設定陷阱
通知問題通常與瀏覽器權限和作業系統的勿擾模式有關。Chrome 在 Windows 上會將網頁通知轉交給系統通知中心,若系統焦點輔助(Focus Assist)開啟,通知會被靜音。開發者可在 chrome://settings/content/notifications 確認 web.whatsapp.com 為「允許」,並在網站內設定(設定 → 通知)檢查「顯示通知」與「通知音效」是否開啟。另一個常見原因是分頁被瀏覽器休眠(Memory Saver),Chrome 在記憶體壓力下會凍結背景分頁,導致 WebSocket 斷線而無法即時收到訊息;可在 chrome://settings/performance 將 web.whatsapp.com 加入「永遠保持活躍」清單。
檔案傳輸失敗則多與檔案大小、格式與網路穩定性有關。WhatsApp 網頁版單檔上限一般為 2GB(依版本與方案可能不同),支援的圖片格式包含 JPG、PNG、WebP,文件則常見 PDF、DOCX、XLSX、ZIP。若上傳進度卡在 0% 超過 30 秒,先檢查 Console 是否有 413 Payload Too Large 或 net::ERR_CONNECTION_RESET;前者表示檔案超過伺服器限制,後者多為代理伺服器中斷連線。可先壓縮圖片至 1MB 以下或將大檔分割後再測試,以區分是檔案本身還是網路通道的問題。
建立可重現的排查記錄
為了避免每次遇到問題都從頭嘗試,建議建立一份簡單的排查記錄表,欄位包含:發生時間、瀏覽器版本、作業系統、錯誤訊息原文、已執行步驟、結果。瀏覽器版本可在網址列輸入 chrome://version 或 about:support(Firefox)取得。多數回報在補充這些資訊後,能快速定位是儲存空間、網路層還是權限設定造成。若問題只在特定分頁出現,可開啟無痕視窗測試;無痕視窗預設不載入擴充功能,若無痕下正常,表示某個擴充功能(常見為廣告阻擋或隱私保護類)干擾了 Service Worker 或 WebSocket。
最後提醒:不要同時執行多個排查步驟。例如一邊清除儲存空間一邊又修改 DNS,會讓判斷依據失效。固定順序的價值在於每一步只改變一個變數,這樣才能確認哪一項設定真正解決了問題。