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

Next.js项目访问页面时出现404错误求助

排查Next.js App Router下/profile页面404的常见原因
  • 路由文件结构不符合App Router规则
    Next.js 13+的App Router要求,路由页面必须放在对应名称的文件夹内,且以page.js(或page.tsx)作为入口文件。你当前的app/profile.js结构不满足规则,Next.js无法识别该文件为路由页面。
    正确的目录结构应为:

    my-nextjs-project/
    └── app/
        └── profile/
            └── page.js
    
  • 文件名/目录名大小写不匹配
    部分系统(如Linux、macOS)区分文件名大小写,如果你的路由目录是Profile/但访问的URL是/profile,会导致路由不匹配,出现404。需保证目录名和URL路径完全一致。

  • App Router未启用
    检查next.config.js中是否存在experimental.appDir: false配置(早期Next.js 13版本需手动开启App Router),如果有,需改为experimental.appDir: true或直接移除该配置,否则App目录下的路由不会生效。

  • 开发服务器缓存未更新
    修改路由结构后,开发服务器可能未自动同步变更。尝试停止服务器后重新执行npm run dev(或yarn dev/pnpm dev),同时清除浏览器缓存后再访问页面。

  • 存在路由冲突或重定向规则
    排查项目中的middleware.js或next.config.js内的重定向、重写规则,这些规则可能会拦截/profile路径,导致页面无法正常访问。


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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.07 17:38:09