如何在Netlify运行.jsx?部署React项目遇404问题求助
部署Netlify时出现“Page Not Found”的排查与解决建议
一、React路由与Netlify配置修复
若项目使用客户端路由(如React Router),Netlify默认不处理路由刷新/直接访问,这是404高发原因:
- 在项目
public目录新建_redirects文件,写入:/* /index.html 200 - 或修正
netlify.toml的路由规则(确保文件在项目根目录):[[redirects]] from = "/*" to = "/index.html" status = 200
- 在项目
检查
App/root.jsx路由配置:- 确认
<BrowserRouter>是否完整包裹所有路由内容,若部署在子路径,需添加basename属性(如basename="/your-subpath")。 - 核查嵌套路由、路径匹配的语法是否符合React Router规范,避免路径冲突或未匹配的情况。
- 确认
二、移除Cloudflare相关配置
- 删除项目中Cloudflare关联文件:比如
wrangler.toml、.env内的Cloudflare变量,或注释掉对应内容。 - 修改
package.json脚本:删除调用Cloudflare部署的命令,保留纯Netlify相关的构建/部署脚本。 - 断开Netlify集成:在Netlify后台的「Integrations」板块找到Cloudflare,解除关联。
三、额外排查步骤
- 本地验证:运行
npm run build构建项目,用serve -s build启动本地服务器测试,若本地也出现404,说明问题在项目代码,重点排查路由逻辑。 - 查看Netlify部署日志:搜索「error」「404」关键词,日志会给出具体报错细节(如构建失败、文件路径错误等)。
内容的提问来源于stack exchange,提问作者Evan Ahmed Shoaib
相关产品推荐
相关产品推荐

