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