跳到内容

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,
}