跳到内容

logging

选项

获取

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

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

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

默认情况下,任何从服务器组件 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,
}