# 排错与后续更新（按需查阅）

配套补充，不需要读完才能上线。资料更新：2026-10-27。

## 卡住时，先按现象排查

| 现象 | 先检查什么 | 怎么处理 |
| --- | --- | --- |
| 临时网址就白屏或首页 404 | 是否上传源码、首页是否套了额外目录 | 重新整理静态成品，检查根层 index.html，再上传完整目录 |
| 首页出来了，图片或样式没有 | Network 的 404、路径和大小写 | 补齐资源，改掉本机路径，重新上传完整成品 |
| 上传有红色警告 | 文件数量、单文件大小 | 对照拖拽上限处理，不忽略失败文件 |
| 临时网址正常，自定义域名不通或 522 | Pages 是否登记该域名、NS 和 DNS 是否正确 | 回到 Custom domains 完成绑定，再核对目标项目；不要只加 CNAME |
| 域名一直 Pending | 账号、NS 生效情况、验证提示、CAA 或 DNSSEC 异常 | 按后台具体提示查证；保留原配置，对照官方说明排查 |
| www 能开，但地址栏不变 | 是否只有 DNS、列表是否绑定启用规则、www 是否代理 | 核对跳转规则和代理状态，再测 Location |
| 提示重定向次数过多 | 是否同时存在反向跳转或重复规则 | 先停用刚添加的冲突规则，保留主域方向，再逐项测试 |
| HTTPS 安全但部分资源被拦 | 页面里的 http 资源 | 改用可正常访问的 HTTPS 资源，检查 Network / Console |
| 更新后仍看到旧内容 | 生产与预览部署是否选错、浏览器缓存 | 先核对生产部署及实际文件，再无痕或硬刷新；不要先改 DNS |
| 搜不到自己的网站 | Search Console 当前索引状态 | 先确认可抓取、无错误 noindex，再看报告，不把提交成功当已收录 |

需要退回上一版时，保留域名和 DNS 配置，优先重新上传之前保存的完整发布成品。页面改坏和域名解析出错是不同层次，别一起改。DNS 迁移出错则根据事先记录的配置排查与恢复，不承诺立即恢复。

## 以后更新：先用原项目上传，Wrangler 再作为补充

第一次上线和日常小更新，都可以继续使用同一个 Pages 项目的后台上传。更新前保留旧成品，更新后检查正式域名，不只看部署成功提示。

熟悉后，才考虑 Wrangler。需要本机 Node.js/npm、Cloudflare 登录授权，以及明确的项目和生产分支。例如下面是**后续更新命令示例**：

```powershell
npx wrangler login
npx wrangler pages project list
npx wrangler pages deploy ./publish --project-name YOUR_PROJECT --branch YOUR_PRODUCTION_BRANCH
```

执行前将 `YOUR_PROJECT`、`YOUR_PRODUCTION_BRANCH` 换成自己的实际值，`publish` 换成只含完整静态成品的文件夹。部署命令会改变远端内容；不要为了跟读文章直接执行。Wrangler 上传文件夹，不直接上传 ZIP。[官方 Wrangler 说明](https://developers.cloudflare.com/pages/get-started/direct-upload/)