You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

无TOML文件时,如何修复Netlify托管React网站的刷新错误?

修复Netlify托管React网站的页面刷新错误(缺少TOML文件时)

React属于单页应用(SPA),前端路由在浏览器端处理。当你刷新页面时,浏览器会直接向Netlify服务器请求对应路径的资源,但服务器上并没有该路径的静态文件,因此会触发刷新错误。解决这个问题的核心是配置Netlify的重写规则,将所有请求指向React应用的入口文件index.html,让前端路由接管路径处理。

解决方案一:创建netlify.toml配置文件

  • 在项目根目录新建netlify.toml文件
  • 写入以下配置内容:
[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200

这个规则会将所有路径的请求重定向到index.html,同时返回200状态码,确保React路由能正常解析刷新后的路径。

解决方案二:使用_redirects文件替代(无需TOML)

如果不想使用TOML格式,也可以用纯文本的重定向文件:

  • 在项目的public目录下新建_redirects文件
  • 写入一行规则:
/* /index.html 200

最后步骤

将新建的配置文件提交到Git仓库,触发Netlify重新部署。部署完成后,页面刷新的问题就会解决。

内容的提问来源于stack exchange,提问作者Short Sins

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.05 20:35:17