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

Netlify部署React项目路由异常:仅加载Home.jsx页面

解决Netlify部署React路由仅加载Home页面的问题

这个问题的核心原因是:Netlify作为静态文件托管服务,默认会直接根据请求路径查找对应的静态资源文件。而React路由属于客户端路由,所有路由逻辑都需要先加载index.html启动应用后,再由前端代码处理路径匹配。直接访问/partner这类非根路径时,Netlify找不到对应的静态文件,就会返回默认的index.html但未正确触发路由逻辑,最终只显示Home页面。

下面是两种可行的解决方法:

方法一:创建_redirects文件

在项目的public目录下(Create React App项目)或项目根目录中,新建名为_redirects的文件,写入以下内容:

/* /index.html 200

这条规则会告诉Netlify:将所有请求都重定向到index.html,交由React路由处理路径匹配。

方法二:配置netlify.toml

如果项目根目录已有netlify.toml文件,或者更习惯用配置文件管理部署规则,添加以下配置:

[[redirects]]
  from = "/*"
  to = "/index.html"
  status = 200

完成配置后重新部署项目,即可正常访问所有React路由路径。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.07 03:43:14