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

Nuxt 3首页访问404求助:需访问/index才能正常加载

Nuxt根路径404仅/index可访问的排查方案
  • 确认pages目录结构:确保index.vue直接放在pages根目录下,而非子文件夹(如pages/home/index.vue)。Nuxt默认将pages/index.vue映射为根路径/,路径嵌套会导致路由匹配异常。
  • 检查nuxt.config路由配置:
    • 查看是否设置了router.base,比如router: { base: '/index/' }会强制根路径指向/index/,需删除或修正该配置。
    • 检查extendRoutes钩子,确认是否自定义修改了根路由/的映射,比如错误地将其指向非index.vue的组件,或未配置根路由规则。
  • 排查中间件/插件干扰:
    • 检查全局中间件是否存在非法路由重定向,比如将/重定向到不存在的路径,导致404。
    • 确认插件是否动态修改了路由配置,覆盖了默认的根路由映射。
  • 清除缓存重启服务:
    • 删除项目根目录下的.nuxt文件夹和node_modules/.cache目录,然后重新执行npm run dev。Nuxt开发模式的路由缓存可能导致配置修改未生效。
  • 检查静态资源冲突:
    • 确认public目录下是否存在index.html文件。如果有,服务器会优先返回静态文件,而非Nuxt渲染的页面,导致/路径返回404(若静态index.html不存在)或非预期内容。
  • Nuxt 3额外检查:
    • 确认未开启app目录模式(若同时存在app和pages目录,Nuxt 3默认优先使用app目录),需确保pages目录的路由配置生效;或检查nuxt.config中是否正确配置了pages模块。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.07.23 19:07:08