Nuxt3开发环境500错误：请求__nuxt_vite_node__/manifest失败

• 未修改任何代码，生产构建（npm run build）可正常运行
• 执行npm run dev启动开发环境时触发500错误，错误信息：

  [nuxt] [request error] [unhandled] [500] fetch failed (http://localhost:3000/__nuxt_vite_node__/manifest)
  

• 已尝试重新构建应用、删除node_modules并重装更新依赖，问题仍未解决

堆栈跟踪信息 #

at async $fetchRaw2 (/D:/IAICB-70/inteliaiclipboard/node_modules/ofetch/dist/shared/ofetch.502a4799.mjs:180:24)
at async /D:/IAICB-70/inteliaiclipboard/.nuxt/dev/index.mjs:745:20
at async /D:/IAICB-70/inteliaiclipboard/.nuxt/dev/index.mjs:826:64
at async /D:/IAICB-70/inteliaiclipboard/.nuxt/dev/index.mjs:378:22
at async Object.handler (/D:/IAICB-70/inteliaiclipboard/node_modules/h3/dist/index.mjs:1196:19)
at async toNodeHandle (/D:/IAICB-70/inteliaiclipboard/node_modules/h3/dist/index.mjs:1271:7)
at async Object.ufetch [as localFetch] (/D:/IAICB-70/inteliaiclipboard/node_modules/unenv/runtime/fetch/index.mjs:9:17)
at async Object.errorhandler [as onError] (/D:/IAICB-70/inteliaiclipboard/.nuxt/dev/index.mjs:462:30)
at async Server.toNodeHandle (/D:/IAICB-70/inteliaiclipboard/node_modules/h3/dist/index.mjs:1278:9)

解决方向 #

1. 检查端口占用 #

localhost:3000可能被其他进程占用，导致Nuxt内部请求无法连接：

• Windows查看端口占用：netstat -ano | findstr ":3000"
• macOS/Linux查看端口占用：lsof -i :3000
• 杀掉占用进程，或修改nuxt.config.ts更换端口：

  export default defineNuxtConfig({
    server: {
      port: 3001 // 换成未被占用的端口
    }
  })
  

2. 清除Nuxt缓存 #

除node_modules外，Nuxt的缓存目录也可能引发问题：

• 删除.nuxt和.output目录
• 执行npx nuxi clean一键清除缓存
• 重新启动开发服务器

3. 排查防火墙/代理干扰 #

本地防火墙或代理工具可能拦截了内部请求：

• 临时关闭防火墙、安全软件测试
• 关闭VPN/代理工具，或在Nuxt配置中设置代理白名单

4. 调整依赖版本 #

该错误与ofetch、h3、unenv等依赖的兼容性有关：

• 查看package.json中的依赖版本，尝试降级到稳定版
• 或升级Nuxt到最新稳定版：npm install nuxt@latest

5. 检查hosts文件 #

确保localhost正确指向127.0.0.1，hosts文件需包含：

127.0.0.1       localhost

内容的提问来源于stack exchange，提问作者gewal007