Debian JS 日志级别设置指南

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

一前置说明

在 Debian 上，日志级别通常由 Node.js 应用或所用日志库控制；前端浏览器 JavaScript 的日志受浏览器/前端框架控制，服务端无法统一设置。
常见日志级别顺序为：error < warn < info < debug（数值越大输出越详细）。
建议通过环境变量或配置文件管理级别，便于不同环境快速切换，无需改代码。

二快速上手 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

说明：内置 console 简单直接，适合小型项目或快速验证。

三使用日志库 Winston 与 Pino

Winston（多传输、结构化日志）

// 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。

四框架与中间件日志

Express + Morgan（HTTP 请求日志）

// 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 负责 HTTP 访问日志，通常与业务日志库配合使用。

五运行环境与进程管理

环境变量方式（通用）

# 临时
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 自身访问日志，不影响 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；变更后重启应用生效。

最新问答

相关标签