Astro + Vercel 网站无法通过百度站长验证的根因与终极解决方案

在给一个 Astro 项目部署到 Vercel 并接入 Cloudflare 后，
我在使用 百度站长平台进行网站验证时，遇到了一个非常”顽固”的问题：

无论使用 文件验证 还是 HTML Meta 验证，
百度都返回：
验证失败：未知原因 308

本文将完整记录 问题成因、排查过程，以及最终可行的工程级解决方案，
希望能帮到遇到同样问题的开发者。

一、问题现象

在百度站长后台进行验证时：

使用 HTML Meta 验证
使用 文件验证

都会失败，错误信息为：

未知原因：308

同时，通过命令行测试发现：

curl -I http://example.com

返回结果类似：

1
HTTP/1.1 308 Permanent Redirect
2
Location: https://example.com/

二、问题根因分析

1️⃣ Vercel 默认行为：HTTP → HTTPS 使用 308

在 Vercel 上部署的网站：

默认强制 HTTPS
使用 308 Permanent Redirect
该行为发生在 应用代码之前

2️⃣ 百度站长验证的技术限制

通过多次验证可以确认：

百度验证阶段 只请求 HTTP
不会跟随 308 / 301 跳转
只接受：

HTTP → 200 OK

一旦返回：

308 / 301
或 HTTP 无法连接（Connection refused）

👉 验证直接失败

3️⃣ Astro 无法像 Next.js 那样拦截 HTTP

与 Next.js 不同：

Astro 没有 middleware
无法在应用层拦截 HTTP 请求
308 在到达 Astro 之前已经发生

4️⃣ Cloudflare 只能”转发”，不能自动伪造 HTTP 200

即便接入 Cloudflare：

关闭 HTTPS 强制
切换 SSL 模式

最终仍会遇到两种结果：

308（Cloudflare 规则触发）
HTTP 80 端口拒绝连接（Vercel 不支持）

三、结论：这是一个架构级冲突

在以下架构下：

Astro + Vercel + Cloudflare

且百度站长 不提供 DNS 验证方式 的前提下：

❌ 文件验证：不可行 ❌ Meta 验证：不可行 ❌ 调整应用配置：不可行

问题并非配置错误，而是系统不兼容。

四、唯一可行的解决方案：Cloudflare Worker

核心思路

在 Cloudflare 边缘 拦截 HTTP 请求 直接返回 200 HTML 绕过 Vercel 与 308

架构示意

百度验证请求
↓
http://example.com
↓
Cloudflare Worker
↓
直接返回 200 + HTML（含验证 Meta）

而正常访问：

https://example.com
↓
Cloudflare
↓
Vercel（Astro 站点）

五、Cloudflare Worker（2025 最新写法）

示例代码（Modules 语法）

1
export default {
2
  async fetch(request) {
3
    const url = new URL(request.url)
4

5
    // 仅处理 HTTP 请求（用于验证）
6
    if (url.protocol === 'http:') {
7
      return new Response(
8
        `<!doctype html>
9
<html>
10
<head>
11
<meta charset="utf-8">
12
<meta name="baidu-site-verification" content="YOUR_CODE">
13
<title>Verification</title>
14
</head>
15
<body>ok</body>
16
</html>`,
17
        {
18
          status: 200,
19
          headers: {
20
            'Content-Type': 'text/html; charset=utf-8',
21
          },
22
        }
23
      )
24
    }
25

26
    // HTTPS 请求正常回源
27
    return fetch(request)
28
  },
29
}

绑定 Worker 路由

http://example.com/*

验证成功标志

curl -I http://example.com

1
HTTP/1.1 200 OK
2
server: cloudflare

此时在百度站长后台点击验证即可通过。

六、验证通过后的安全处理（推荐）

验证完成后，建议将 Worker 改为：

1
if (url.protocol === 'http:') {
2
  return Response.redirect('https://example.com/', 301)
3
}

并将 Cloudflare SSL 模式恢复为：

Full (Strict)

七、经验总结

一句话结论

Astro + Vercel 架构下，百度站长验证只能在 CDN / DNS 层解决。

技术要点回顾

308 是现代平台的正确行为
百度验证系统仍停留在”HTTP 200 时代”
Cloudflare Worker 是唯一可控的 HTTP 边缘层

八、写在最后

这并不是某个平台的 Bug，而是：

传统搜索系统与现代云架构之间的兼容问题

如果你使用：

Astro
Vercel
Cloudflare
且需要接入百度站长

希望这篇文章能帮你 少踩几个坑。