返回
🔧

Cloudflare Pages 部署踩坑实录:从 522 报错到完美重定向

在上一篇文章中,我分享了如何使用 Cloudflare Pages 部署网站的完整流程。但实际操作中,我踩了不少坑,特别是在域名绑定和 DNS 配置这块。今天就来聊聊这些真实遇到的问题和解决方案,希望能帮你少走弯路。

💡 背景说明:本文基于我在配置 xbmlz.cnxbkjz.icu 两个域名时的真实经历,所有问题都是实际遇到并解决的。

陷阱一:只做 DNS 解析,不做 Pages 绑定

❌ 问题现象

访问网站时出现 Error 522 Connection Timed Out,或者 Cloudflare 提示"主机错误"。明明在 DNS 列表里已经添加了 CNAME 记录,状态也显示"已代理"(橙色云朵),但网站就是打不开。

为什么会这样?

这是我遇到的第一个坑,也是最容易犯的错误。当时我以为只要在 Cloudflare DNS 里添加了解析记录就行了,结果折腾了半天网站还是访问不了。

后来才明白,Cloudflare 的逻辑是"双向确认":

如果只做了 DNS 解析,流量虽然到了 Cloudflare,但 Cloudflare 不知道要把请求转发给哪个 Pages 项目,自然就报错了。

✅ 解决方案

  1. 进入 Cloudflare Dashboard,点击左侧 Workers & Pages
  2. 选择你的项目(比如我的 xiaobao-astrology
  3. 点击 Custom domains 标签
  4. 点击 Set up a custom domain
  5. 分别添加 www.你的域名.com你的域名.com
  6. 等待状态变为绿色的 Active
⚠️ 重要提示:www 和根域名(@)都要绑定,缺一不可。很多人只绑定了一个,导致另一个无法访问。

陷阱二:域名拼写错误

❌ 问题现象

配置了重定向规则,域名也绑定了,但状态一直显示黄色的"Pending"或"Inactive",SSL 证书也无法颁发,规则完全不生效。

真实案例

这个坑我印象特别深刻。当时在配置 xbkjz.icu 的重定向规则时,不知道哪根筋搭错了,把域名写成了 bkjz.icu,少了开头的 x

因为配置界面要填的地方很多,来回切换时眼睛都看花了,完全没注意到这个低级错误。结果折腾了一个多小时,重新部署了好几次,状态就是不变绿。

为什么容易出错?

✅ 解决方案

在点击"保存"或"部署"之前,务必仔细核对以下三处的域名拼写:

  1. 域名注册商(腾讯云/阿里云)显示的域名
  2. Cloudflare Pages 自定义域绑定的域名
  3. 重定向规则中填写的域名
💡 小技巧:建议把域名复制到记事本,每次需要输入时都从记事本复制,避免手动输入出错。

进阶配置:301 重定向

域名绑定成功后,还有一个重要的优化:配置 301 重定向,统一 www 和根域名的访问入口。这对 SEO 和用户体验都很重要。

为什么需要重定向?

配置步骤

在 Cloudflare Dashboard 中:

  1. 进入你的域名管理页面
  2. 点击左侧 RulesRedirect Rules
  3. 点击 Create rule

方案一:动态重定向(推荐)

这种方式可以保留完整的 URL 路径和参数:

规则名称:WWW to Root Domain

匹配条件:
- 字段:Hostname
- 运算符:equals
- 值:www.xbkjz.icu

URL 重定向(动态):
- 表达式:concat("https://xbkjz.icu", http.request.uri.path)
- 状态代码:301
- 保留查询字符串:开启

方案二:静态重定向(简单)

如果觉得动态表达式太复杂,也可以用静态方式:

请求 URL:https://www.xbkjz.icu/*
目标 URL:https://xbkjz.icu/$1
状态代码:301
⚠️ 注意:URL 末尾的 *$1 很重要,它们确保子路径能正确转发。比如 www.example.com/about 会重定向到 example.com/about

完整配置检查清单

📋 部署前检查

  1. ✅ DNS 已迁移到 Cloudflare(或添加了正确的 CNAME 记录)
  2. ✅ 在 Pages 项目中绑定了 www 和根域名
  3. ✅ 所有域名拼写完全一致,没有多余或缺少字母
  4. ✅ 域名状态显示为绿色 Active
  5. ✅ SSL 证书已自动颁发(通常几分钟内完成)
  6. ✅ 配置了 301 重定向规则
  7. ✅ 测试访问 www 和根域名都能正常打开

常见问题排查

Q: 为什么 SSL 证书一直显示"Pending"?

可能的原因:

解决方法:先检查域名拼写,确认 DNS 记录正确,然后耐心等待。如果超过 24 小时还是不行,可以尝试删除重新绑定。

Q: 重定向规则不生效怎么办?

检查以下几点:

Q: 部署成功但访问很慢?

这通常不是配置问题,可能是:

写在最后

回顾这次折腾,最大的感受就是:细节决定成败。很多问题看起来很复杂,其实就是一个字母拼错、一个步骤漏掉导致的。

Cloudflare Pages 本身是个很优秀的服务,配置也不算复杂,但对新手来说确实有些门槛。希望这篇文章能帮你避开这些坑,顺利完成部署。

如果你在部署过程中遇到其他问题,欢迎在评论区交流。折腾愉快!🎉

💬 评论区 (0)

0/500

加载评论中...

© 2026 小宝科技站 All Rights Reserved