关键结论

纯静态的 Astro 站点不需要 @astrojs/cloudflare adapter。 直接 astro builddist/,然后把 dist/ 推给 Cloudflare Pages 就完事了。

事实上,从 2025 年起 @astrojs/cloudflare 不再支持 Cloudflare Pages(迁往 Workers)。所以:

你的情况推荐路径
纯静态博客 / 文档站不要装 adapter,直接 Pages 静态部署
有 SSR / API routes用 adapter,目标改为 Workers,弃用 Pages

配置三步走

  1. astro build 产物在 dist/
  2. Cloudflare Pages 关联 GitHub 仓库
  3. Build command:npm run build,Output directory:dist

剩下的就交给 Cloudflare 的 CI 自动跑了。