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

如何在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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.06.26 10:20:01