如何在Nuxt 3预渲染生成时查看详细错误信息

问题场景 #

执行nuxt generate命令时，多个/admin路由预渲染失败，仅返回Error: [500]，无详细错误信息，无法排查问题。错误日志如下：

├─ /admin/menu/create (1669ms)                                                                        nitro 14:10:49
  │ └── Error: [500]
  ├─ /admin (1709ms)                                                                                    nitro 14:10:49
  │ └── Error: [500]
  ├─ /admin/menu (1717ms)                                                                               nitro 14:10:49
  │ └── Error: [500]
  ├─ /admin/order/today (1755ms)                                                                        nitro 14:10:49
  │ └── Error: [500]
  ├─ /admin/order/history (1980ms)                                                                      nitro 14:10:50
  │ └── Error: [500]
  ├─ /menu (13189ms)                                                                                    nitro 14:11:01
  ├─ /menu/_payload.json (0ms)                                                                          nitro 14:11:01
                                                                                                        nitro 14:11:01
Errors prerendering:
  ├─ /admin/menu/create (1669ms)                                                                        nitro 14:11:01
  │ └── Error: [500]
  ├─ /admin (1709ms)                                                                                    nitro 14:11:01
  │ └── Error: [500]
  ├─ /admin/menu (1717ms)                                                                               nitro 14:11:01
  │ └── Error: [500]
  ├─ /admin/order/today (1755ms)                                                                        nitro 14:11:01
  │ └── Error: [500]
  ├─ /admin/order/history (1980ms)                                                                      nitro 14:11:01
  │ └── Error: [500]
                                                                                                        nitro 14:11:01

ERROR Exiting due to prerender errors. 14:11:01
at prerender (/D:/Project/Web/rara%20order%20food/fe/node_modules/nitropack/dist/shared/nitro.3d0a4b01.mjs:214:11)

at async /D:/Project/Web/rara%20order%20food/fe/node_modules/nuxt/dist/index.mjs:2986:7

at async build (/D:/Project/Web/rara%20order%20food/fe/node_modules/nuxt/dist/index.mjs:4375:5)

at async Object.run (/D:/Project/Web/rara%20order%20food/fe/node_modules/nuxi/dist/chunks/build.mjs:92:5)

at async Object.run (/D:/Project/Web/rara%20order%20food/fe/node_modules/nuxi/dist/chunks/generate.mjs:61:5)

at async runCommand$1 (/D:/Project/Web/rara%20order%20food/fe/node_modules/nuxi/dist/shared/nuxi.c6444792.mjs:1647:7)

at async runCommand$1 (/D:/Project/Web/rara%20order%20food/fe/node_modules/nuxi/dist/shared/nuxi.c6444792.mjs:1638:11) at async runMain$1 (/D:/Project/Web/rara%20order%20food/fe/node_modules/nuxi/dist/shared/nuxi.c6444792.mjs:1770:7)
ERROR Exiting due to prerender errors.

当前nuxt.config.ts配置：

export default defineNuxtConfig({
  devtools: { enabled: true },
  modules: [
    '@pinia/nuxt',
  ],
  app: {
    head: {
      title: 'Rafa Order Shop',
      charset: 'utf-8',
      viewport: 'width=device-width, initial-scale=1',
      meta: [
        { name: 'description', content: 'My amazing site.' }
      ],
      link: [
        {
          href: 'https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/css/bootstrap.min.css',
          rel: 'stylesheet'
        },
        {
          href: 'https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.1/font/bootstrap-icons.css',
          rel: 'stylesheet'
        }
      ],
      script: [
        {
          src: 'https://cdn.jsdelivr.net/npm/bootstrap@5.3.2/dist/js/bootstrap.bundle.min.js'
        }
      ]
    },
    buildAssetsDir: 'assets'
  }
})

解决方法 #

1. 启用Nitro调试日志 #

执行生成命令时添加--log-level debug参数，获取更详细的错误输出：

nuxt generate --log-level debug

这会打印预渲染过程中的所有调试信息，包括具体的错误栈和触发点。

2. 修改Nuxt配置捕获详细错误 #

在nuxt.config.ts中添加Nitro配置，强制输出完整错误信息：

export default defineNuxtConfig({
  // 原有配置...
  nitro: {
    logLevel: 'debug',
    prerender: {
      failOnError: true,
      // 可选：添加错误处理钩子捕获详细信息
      hooks: {
        'prerender:error': (error) => {
          console.error('预渲染详细错误:', error)
        }
      }
    }
  }
})

重新执行nuxt generate，控制台会输出每个500错误的具体详情。

3. 临时禁用特定路由预渲染 #

如果admin路由不需要预渲染（比如是后台管理页面，仅需客户端渲染），可以在配置中排除这些路由，先确保其他页面正常生成，再单独排查admin路由问题：

export default defineNuxtConfig({
  // 原有配置...
  nitro: {
    prerender: {
      routes: ['/'], // 仅预渲染首页
      ignore: ['/admin/**'] // 忽略所有admin开头的路由
    }
  }
})

4. 本地模拟预渲染请求 #

启动Nuxt开发服务器后，直接访问http://localhost:3000/__nuxt_prerender__/admin（替换为对应的失败路由），查看页面是否能正常加载，浏览器控制台会显示具体的客户端或服务端错误。

内容的提问来源于stack exchange，提问作者Harun Ar Rasyid