Markdown 回應缺少 Vary: Accept
簡短回答
頁面在本身的 URL 以 Markdown 回應 Accept: text/markdown,但該回應沒有 Vary: Accept 標頭。CDN 或瀏覽器快取可能存下 Markdown 並顯示給下一位訪客,或存下 HTML 並交給 AI 代理。
代表什麼
頁面在被要求 text/markdown 時,會在同一個 URL 回傳 Markdown,但該回應沒有 Vary: Accept 標頭。CDN 或瀏覽器快取因此可能把 Markdown 顯示給訪客。
為什麼這對 AI 搜尋很重要
快取以 URL 來辨識存下的回應。Vary: Accept 會告訴快取,回應取決於 Accept 標頭,於是 HTML 和 Markdown 會分開存放。沒有它,最先被快取的版本就會提供給所有人。
這個問題只會偶爾出現,也就是快取清除後的第一個請求剛好來自代理時,所以很難從瀏覽器察覺。
如何修正
- 在 Markdown 回應,以及同一個 URL 的 HTML 回應中,都加入
Vary: Accept。 - 如果轉換是在 CDN 或框架中介軟體中進行,就在同一個地方設定該標頭。
- 變更後清除該頁面的快取。
- 在頁面報告上按「再次檢查」確認結果。
範例
# both answers of the same URL
Content-Type: text/markdown; charset=utf-8
Vary: Accept 如何確認修正
修改後,在報告上按下「再次檢查」:它會列出已修正的項目以及分數的變化。