Debian JS 日志级别设置指南

Debian 环境下 Ja vaScript 日志级别设置指南

一 前置说明

在开始之前，有几个关键点需要先明确。在 Debian 系统上，日志级别的控制权其实取决于你的应用场景：Node.js 后端应用的日志由应用自身或其使用的日志库来管理；而前端浏览器里的 Ja vaScript 日志，则完全由浏览器或前端框架控制，服务端是没法统一设置的。

说到日志级别，一个常见的顺序是：error < warn < info < debug。数值越大，输出的信息就越详细。这里有个最佳实践：强烈建议通过环境变量或者配置文件来管理日志级别。这样做的好处是，在不同环境（比如开发、测试、生产）之间切换时，你只需要改个配置，而无需去动代码，既灵活又安全。

二 快速上手 Node.js 内置日志

如果你需要一个轻量级的方案，Node.js 内置的 console 对象其实就能玩出花样。核心思路是利用环境变量来控制不同级别的输出。

// 级别映射：数值越大越详细
const levels = { error: 0, warn: 1, info: 2, debug: 3 };
const current = levels[process.env.LOG_LEVEL || 'info'];

function log(level, msg) {
  if (levels[level] >= current) console[level](msg);
}

log('info', '服务已启动');
log('debug', '调试信息'); // 仅在 LOG_LEVEL=debug 时输出

启动应用时，只需要带上相应的环境变量即可：

LOG_LEVEL=debug node app.js

这种方式简单直接，非常适合小型项目或者快速验证某个想法。当然，对于更复杂的场景，你可能就需要更专业的工具了。

三 使用日志库 Winston 与 Pino

当项目规模增长，对日志的结构化、持久化或性能有更高要求时，专业的日志库就成了不二之选。

Winston 以其灵活性和强大的传输（Transport）能力著称，支持将日志输出到控制台、文件甚至远程服务，并且能方便地输出结构化日志（比如 JSON 格式）。

// npm i winston
const winston = require('winston');
const logger = winston.createLogger({
  level: process.env.LOG_LEVEL || 'info',
  format: winston.format.json(),
  transports: [
    new winston.transports.Console(),
    new winston.transports.File({ filename: 'error.log', level: 'error' }),
    new winston.transports.File({ filename: 'combined.log' })
  ]
});

logger.info('应用启动', { pid: process.pid });
logger.error('发生错误', { err: new Error('boom') });

而 Pino 则是另一个极端，它主打极致的性能和低开销，特别适合对吞吐量要求极高的应用。

// npm i pino
const pino = require('pino');
const logger = pino({ level: process.env.LOG_LEVEL || 'info' });

logger.info('应用启动');
logger.error({ err: new Error('boom') }, '发生错误');

无论选择哪一个，关键操作都是一样的：将日志级别（level）绑定到环境变量 process.env.LOG_LEVEL 上。这样一来，生产环境通常设为 info 保证可读性，一旦需要排查问题，瞬间就能切换到 debug 模式，获取最详尽的信息。

四 框架与中间件日志

对于 Web 应用，特别是使用 Express 框架的场景，HTTP 请求日志是必不可少的。这时，Morgan 中间件就是你的得力助手。

// npm i express morgan
const express = require('express');
const morgan = require('morgan');
const app = express();

// 开发：简洁；生产：combined（更详细）
app.use(morgan(process.env.NODE_ENV === 'development' ? 'dev' : 'combined'));

app.get('/', (req, res) => res.send('Hello World'));
app.listen(3000, () => console.log('Server on :3000'));

Morgan 专门负责记录访问日志，其格式可以通过参数灵活调整。它通常与 Winston 或 Pino 这类业务日志库配合使用，各司其职，共同构建完整的应用日志体系。

五 运行环境与进程管理

最后，如何在实际运行环境中应用这些设置？这里有几个主流的方法。

环境变量方式是最通用和推荐的做法，无论是在命令行临时设置，还是在 Shell 配置中持久化，都非常方便。

# 临时设置
LOG_LEVEL=debug node app.js

# 持久化（当前会话）
export LOG_LEVEL=debug
node app.js

如果你使用 PM2 这类进程管理器，那么可以通过配置文件来为不同环境预设变量，管理起来更加清晰。

// ecosystem.config.js
module.exports = {
  apps: [{
    name: 'my-app',
    script: 'app.js',
    env: {
      NODE_ENV: 'development',
      LOG_LEVEL: 'debug'
    },
    env_production: {
      NODE_ENV: 'production',
      LOG_LEVEL: 'info'
    }
  }]
};

启动时指定环境即可：

pm2 start ecosystem.config.js --env production

另外，有时会混淆一个概念：Nginx 的日志级别。需要明确的是，Nginx 配置中的 log_level 指令（如下所示）仅控制 Nginx 自身错误日志的详细程度，与你 Node.js 应用的业务日志完全是两回事。

http {
  log_level info; # 可选：debug | info | notice | warn | error
  server { ... }
}
# 修改后执行：sudo systemctl restart nginx

当然，除了环境变量，传统的配置文件方式也依然可行，尤其适合那些已经有一套成熟配置管理方案的项目。

{
  "logging": { "level": "debug" }
}

在代码中读取配置：

const config = require('config');
const level = config.get('logging.level') || 'info';

总而言之，一个黄金法则是：生产环境默认使用 info 级别，在需要深入排查问题时再动态切换到 debug。记住，任何日志级别的变更，通常都需要重启应用才能生效。