HTTPS 與安全響應頭故障排查:從現象到根因

安全響應頭引發的故障,通常有明確對應關係:白屏看 CSP,登入循環看 Cookie 與 HSTS,iframe 打不開看 frame 限制,資源失敗看來源白名單。

資訊中心:HTTPS 與安全響應頭故障排查:從現象到根因

現象一:頁面白屏或樣式丟失

根因: CSP 阻止了樣式、字型或指令碼。

排查:

  1. 打開 Console 看 Content Security Policy 阻斷記錄。
  2. 確認被攔資源的來源。
  3. 在 Report-Only 下補齊來源,再切正式策略。

現象二:登入後反復跳回登入頁

根因: Cookie 的 Secure、SameSite 與 HTTPS/HSTS 設定不匹配,或重定向鏈丟失工作階段。

排查:

  1. 看 Set-Cookie 的 Secure 和 SameSite。
  2. 確認登入請求全程 HTTPS。
  3. 檢查反向代理是否正確傳遞協議頭。

現象三:嵌入頁面打不開

根因: X-Frame-Options 或 CSP frame-ancestors 不允許當前來源。

排查:

  1. 確認是誰嵌誰。
  2. 只放行必要來源,不用 *。
  3. 舊站點同時保留 X-Frame-Options 相容。

現象四:介面或圖片載入失敗

根因: connect-src、img-src 未包含實際網域,或 CORS 與 CSP 雙重限制。

排查:

  1. 看失敗請求的目標網域。
  2. 區分 CSP 阻斷和 CORS 拒絕。
  3. 逐項加入白名單。

現象五:改了設定但使用者不生效

根因: CDN 或瀏覽器快取了舊響應頭。

排查:

  1. 用 curl -I 直接打源站。
  2. 再打 CDN 網域。
  3. 重新整理快取並確認 HTML 快取策略。

現象六:HSTS 導致測試環境無法訪問

根因: 瀏覽器記住了 HSTS,測試網域仍走 HTTPS 但證書無效。

排查:

  1. 換未受影響的網域測試。
  2. 清除該網域的 HSTS 記錄。
  3. 生產環境先用短 max-age。

復原順序

  1. 關閉 CSP 或降爲 Report-Only。
  2. 移除 HSTS(注意瀏覽器已快取的部分無法立即復原)。
  3. 放開 frame 限制。
  4. 復核登入、支付、嵌入。
  5. 記錄根因,改完再灰度。

邊界

響應頭故障常與代理、CDN、框架預設設定疊加。排查時要區分“源站返回什麼”和“使用者收到什麼”,不能只看應用程式碼。

相關閱讀: