跳到正文

此设备上的 Yave 统一账号登录将会结束,在此设备上使用的其他 Yave 服务也会一并退出登录。

SPA 刷新出现 404?一个设置就能解决

最后更新: 2026-11-11

目录 · 6
  1. 1. 上传构建结果的文件夹
  2. 2. 确认 SPA 选项已经开启
  3. 3. 用直接链接和刷新测试
  4. 4. 同时想用 404 页面?二选一
  5. 常见问题
  6. 延伸阅读

先说结论:在网站设置 ▸ 站点展开更多,开启“不存在的网址也打开首页(适用于应用式网站)”,React、Vue 网站的直接链接和刷新就会打开你的应用,而不是 404。要注意的是,开启后“访问不存在的网址时显示的页面”在普通网址上不会被使用,所以请根据网站类型二选一。

要点速览

所需时间
约 2 分钟
所需套餐
免费即可
代码知识
不需要
操作位置
编辑器

操作步骤

  1. 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. 2

    确认 SPA 选项已经开启

    以 ZIP、文件夹或 GitHub 导入后,如果文件明确是这种应用结构,选项会自动开启,编辑器也会告诉你。想自己确认的话,从左侧的设置 ▸ 网站设置 ▸ 站点展开更多,开启“不存在的网址也打开首页(适用于应用式网站)”。修改会自动保存,不用重新发布就会立刻生效。

    编辑器网站设置的站点标签页:网站语言、主题色、访问不存在的网址时显示的页面,展开更多后可看到应用安装和“不存在的网址也打开首页”的开关
    网站设置 ▸ 站点 ▸ 更多里有 SPA 开关
  3. 3

    用直接链接和刷新测试

    在你的网址后面加上应用的路径打开,再刷新。看到的是应用页面而不是 404 就成功了。只有页面型网址(没有扩展名)会打开首页;图片或脚本这类有扩展名的文件如果不存在,仍然是 404。

    myname.html2site.com/about 已发布

    开启开关后,刷新这个网址也会打开你的应用

  4. 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 是正常的;请检查应用加载的文件路径是否正确。

动手比阅读更快 — 粘贴你的 HTML,马上发布。

在当前工作区中查找网站。如需切换工作区,请在侧边栏顶部切换。