devIndicators

devIndicators 允许你配置屏幕上的指示器，在开发过程中提供当前查看路由的上下文信息。

  devIndicators: false | {
    position?: 'bottom-right'
    | 'bottom-left'
    | 'top-right'
    | 'top-left', // 默认为 'bottom-left'，
  },

将 devIndicators 设置为 false 将隐藏指示器，但 Next.js 仍会显示遇到的任何构建或运行时错误。

故障排除

指示器未将路由标记为静态

如果你期望路由是静态的，但指示器将其标记为动态，则该路由可能已选择退出静态渲染。

你可以通过使用 next build --debug 构建应用程序来确认路由是静态还是动态，并检查终端中的输出。静态（或预渲染）路由将显示 ○ 符号，而动态路由将显示 ƒ 符号。例如：

Route (app)
┌ ○ /_not-found
└ ƒ /products/[id]
 
○  (Static)   prerendered as static content
ƒ  (Dynamic)  server-rendered on demand

路由可能选择退出静态渲染有两个原因：

• 存在依赖运行时信息的 Dynamic APIs。
• 存在未缓存的数据请求，例如对 ORM 或数据库驱动程序的调用。

检查你的路由是否存在这些条件，如果无法静态渲染路由，则考虑使用 loading.js 或 <Suspense /> 来利用流式传输。

版本历史