日志记录

日志记录

配置选项

您可以配置日志级别以及是否在开发模式下将完整 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,
}