Markdown 响应缺少 Vary: Accept

简短回答

页面在自身 URL 上用 Markdown 响应 Accept: text/markdown,但该响应没有 Vary: Accept 标头。CDN 或浏览器缓存可能会存下 Markdown 并展示给下一位访客,或者存下 HTML 并交给智能体。

agent.markdown_no_vary · 优先级: P3

含义

页面在被请求 text/markdown 时会在同一 URL 返回 Markdown,但该响应没有 Vary: Accept 标头。CDN 或浏览器缓存可能因此把 Markdown 展示给访客。

为什么这对 AI 搜索很重要

缓存按 URL 来标识已存储的响应。Vary: Accept 告诉缓存,响应取决于 Accept 标头,于是 HTML 和 Markdown 会分开存放。没有它,先被缓存的那个版本就会提供给所有人。

这个问题只会偶尔出现:当缓存清除后的第一个请求来自智能体时才会发生,所以从浏览器里很难察觉。

如何修复

  1. 给 Markdown 响应以及同一 URL 的 HTML 响应都加上 Vary: Accept。
  2. 如果转换在 CDN 或框架中间件中进行,就在同一位置设置该标头。
  3. 修改后清除该页面的缓存。
  4. 在页面报告中点击“再次检测”确认结果。

示例

# both answers of the same URL
Content-Type: text/markdown; charset=utf-8
Vary: Accept

如何确认修复

修改后,在报告上点击“再次检测”:它会列出已修复的内容以及评分的变化。

检测我的页面 →

相关指南

所有发现及评分计算方式