Morgan 中间件简介：Express 应用程序中的日志记录

2023-11-28 12:04:38

Morgan 中间件：Express 应用程序中的强大日志记录

在现代 Web 开发中，日志记录是一个至关重要的方面，它可以帮助我们洞察应用程序的行为、诊断问题和监控整体系统健康状况。在 Express 框架中，Morgan 中间件脱颖而出，成为一个备受推崇的工具，它可以轻松地记录有关传入 HTTP 请求的重要信息。

Morgan 的简单入门

Morgan 的使用非常简单，只需将其作为 Express 应用程序的中间件添加到项目中即可。通过以下代码片段，我们可以记录所有传入请求的基本信息：

const express = require('express');
const morgan = require('morgan');

const app = express();

app.use(morgan('dev'));

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});

使用 morgan('dev')，我们指定使用 Morgan 的 dev 格式，它将记录以下信息：

请求方法
请求 URL
请求状态码
响应时间（以毫秒为单位）
请求大小（以字节为单位）

高级用法：定制日志输出

Morgan 提供了广泛的高级选项，允许我们根据具体需求定制日志输出的格式和内容。我们可以传递一个格式字符串作为参数来指定自定义格式。例如，以下格式字符串将记录更详细的信息：

app.use(morgan(':date[iso] :method :url :protocol :status :response-time :res[content-length] :req[user-agent]'));

Morgan 还提供了预定义的格式，我们可以直接使用它们。tiny 格式提供了简洁的信息，而 combined 格式则提供了最全面的日志输出。

揭开 Morgan 的神秘面纱

Morgan 的原理非常简单，它本质上是一个 Connect/Express 中间件，在请求处理管道中执行。当一个请求到达时，Morgan 记录有关请求的信息，然后将其传递给下一个中间件。如果请求到达最终处理程序，Morgan 也会记录有关响应的信息。

动手实践：模拟 Morgan

为了深入理解 Morgan 的工作原理，我们可以尝试编写自己的简单日志记录中间件。以下代码段展示了一个基本的实现：

const express = require('express');

const app = express();

app.use((req, res, next) => {
  const logEntry = `${req.method} ${req.url} ${res.statusCode} ${Date.now() - req.startTime}ms`;
  console.log(logEntry);

  next();
});

app.listen(3000, () => {
  console.log('Server is running on port 3000');
});