跳到内容

logging

选项

获取

你可以配置日志记录级别,以及在开发模式下运行 Next.js 时是否将完整 URL 记录到控制台。

目前,logging 仅适用于使用 fetch API 进行的数据获取。它尚未应用于 Next.js 内部的其他日志。

next.config.js
module.exports = {
  logging: {
    fetches: {
      fullUrl: true,
    },
  },
}

任何从 Server Components HMR 缓存 恢复的 fetch 请求默认情况下都不会记录。但是,可以通过将 logging.fetches.hmrRefreshes 设置为 true 来启用此功能。

next.config.js
module.exports = {
  logging: {
    fetches: {
      hmrRefreshes: true,
    },
  },
}

接收请求

默认情况下,所有接收的请求都将在开发期间记录在控制台中。你可以使用 incomingRequests 选项来决定要忽略哪些请求。由于这仅在开发中记录,因此此选项不会影响生产构建。

next.config.js
module.exports = {
  logging: {
    incomingRequests: {
      ignore: [/\api\/v1\/health/],
    },
  },
}

或者你可以通过将 incomingRequests 设置为 false 来禁用接收请求日志记录。

next.config.js
module.exports = {
  logging: {
    incomingRequests: false,
  },
}

禁用日志记录

此外,你可以通过将 logging 设置为 false 来禁用开发日志记录。

next.config.js
module.exports = {
  logging: false,
}