SPA 刷新出现 404?一个设置就能解决
最后更新: 2026-11-11
先说结论:在网站设置 ▸ 站点展开更多,开启“不存在的网址也打开首页(适用于应用式网站)”,React、Vue 网站的直接链接和刷新就会打开你的应用,而不是 404。要注意的是,开启后“访问不存在的网址时显示的页面”在普通网址上不会被使用,所以请根据网站类型二选一。
要点速览
- 所需时间
- 约 2 分钟
- 所需套餐
- 免费即可
- 代码知识
- 不需要
- 操作位置
- 编辑器
操作步骤
- 1
上传构建结果的文件夹
React、Vue、Vite 网站请上传构建命令生成的文件夹(通常是 dist),可以压缩成 ZIP,也可以整个文件夹上传。这类网站的 index.html 几乎是空的,由脚本绘制页面。所以像 /about 这样的网址没有对应文件,设置关闭时,直接打开或刷新该网址就会出现 404。
index.html<!doctype html><div id="root"></div><script type="module" src="/assets/index.js"></script> - 2
确认 SPA 选项已经开启
以 ZIP、文件夹或 GitHub 导入后,如果文件明确是这种应用结构,选项会自动开启,编辑器也会告诉你。想自己确认的话,从左侧的设置 ▸ 网站设置 ▸ 站点展开更多,开启“不存在的网址也打开首页(适用于应用式网站)”。修改会自动保存,不用重新发布就会立刻生效。
网站设置 ▸ 站点 ▸ 更多里有 SPA 开关 - 3
用直接链接和刷新测试
在你的网址后面加上应用的路径打开,再刷新。看到的是应用页面而不是 404 就成功了。只有页面型网址(没有扩展名)会打开首页;图片或脚本这类有扩展名的文件如果不存在,仍然是 404。
myname.html2site.com/about 已发布开启开关后,刷新这个网址也会打开你的应用
- 4
同时想用 404 页面?二选一
“访问不存在的网址时显示的页面”在网站设置 ▸ 站点,从本站现有的页面中选择(不选则显示默认 404 页面)。多页的普通网站适合用这个,并把 SPA 开关保持关闭。开关一开,不存在的网址也会打开首页,那个 404 页面就用不上了。如果想在应用里显示“找不到页面”,请在应用自己的路由中制作。
网站设置 ▸ 站点访问不存在的网址时显示的页面 默认 404 页面不存在的网址也打开首页 ON
常见问题
为什么我的 React 应用刷新会出现 404?
单页应用不是每个网址都有一个文件,而是由浏览器里的脚本读取网址后绘制页面。静态托管会找与网址同名的文件,/about 没有对应文件,就返回 404。开启 SPA 选项后,那个网址会改为返回首页,由你的应用接手。
SPA 选项需要自己开启吗?
以 ZIP、文件夹或 GitHub 导入后,如果文件明确是应用结构(例如由脚本填入内容的空首页),会自动开启。如果迹象比较弱,网站设置的更多里会显示附理由的建议。无论哪种情况,都能用开关自行开启或关闭。
普通网站也可以一直开着吗?
不建议。开启后,所有输错的网址都会打开首页,你的自定义 404 页面完全用不上,搜索引擎也可能把不存在的网址当成真的页面。每个页面都有对应文件的网站,请保持关闭。
SPA 网站还能显示“找不到页面”的画面吗?
这个选项会把不存在的网址送到首页,所以那个画面要由应用自己的路由来提供。如果想用 404 页面,请关闭开关,并在“访问不存在的网址时显示的页面”选一个页面。
已经开启了还是出现 404 怎么办?
先确认文件列表里有首页(index.html),没有的话就没有东西可打开,会出现 404。另外 .js、.png 这类有扩展名的网址,文件不存在时返回 404 是正常的;请检查应用加载的文件路径是否正确。
延伸阅读
- 把网站文件夹压成 ZIP 上传,拥有自己的网址 把有 CSS、JS、图片、多个页面的网站,用 ZIP 或整个文件夹免费发布到自己网址的教程(简体中文)
- 导入 GitHub 仓库,部署成静态网站 把公开 GitHub 仓库的静态文件导入并免费发布到自己网址的教程:不构建、需要 index.html(简体中文)
- 已发布的网站,怎么还原到旧版本 把已发布的网站还原到旧版本:查看、还原、撤销还原,以及免费方案和 Plus 的保留范围(简体中文)
- 如何把自己的域名绑定到网站 把自己的域名绑定到已发布 HTML 网站的分步教程:输入地址、在域名购买处添加 CNAME 与 TXT 值、等待连接完成、HTTPS 自动启用(Plus 起)