Next.js 14 App Router服务器日志未在K8s Pod中显示的问题

可能原因及解决步骤 #

1. 确认API路由是否被实际触发 #

先通过curl或其他工具手动调用你的API路由（比如curl http://<pod-ip>/api/xxx），如果调用后仍无日志，再排查后续问题；如果调用后出现日志，说明之前只是未触发路由而已。

2. 检查Next.js生产构建是否移除了console.log #

Next.js默认不会移除console.log，但如果你的next.config.js里配置了webpack的Terser插件自动删除console，会导致生产模式下日志消失。检查配置：

// next.config.js 里是否有类似配置
module.exports = {
  webpack: (config) => {
    config.optimization.minimizer.forEach(minimizer => {
      if (minimizer instanceof require('terser-webpack-plugin').TerserPlugin) {
        minimizer.options.terserOptions.compress.drop_console = true;
      }
    });
    return config;
  },
};

如果有，删除drop_console相关配置，或者改为仅删除特定类型的console（比如将drop_console: true改为drop_console: false）。

3. 调整Next.js日志级别 #

Next.js的日志系统默认可能过滤了部分输出，在next.config.js中设置更详细的日志级别：

module.exports = {
  logging: {
    level: 'verbose', // 可选值：'fatal' | 'error' | 'warn' | 'info' | 'verbose'
  },
};

4. 排除Node.js输出缓冲问题 #

Node.js在非交互式环境（比如K8s容器）下，stdout是缓冲输出的，可能导致日志不会实时显示。可以尝试：

• 将API路由中的console.log替换为console.error（stderr无缓冲，会实时输出），测试是否能在Pod日志中看到；
• 启动Next.js时添加环境变量NODE_ENV=production，确保运行在生产模式下（开发模式的日志行为不同）。

5. 检查K8s日志收集配置（可能性较低） #

如果上述步骤都无效，确认K8s的日志收集是否过滤了stdout的日志：

• 查看Pod的日志驱动配置，是否只收集stderr；
• 检查是否有日志采集sidecar（比如fluentd）设置了日志级别过滤。

内容的提问来源于stack exchange，提问作者tiger t