Node.js中间件的5个注意事项

1. 目录结构

2. 代码实现

注意事项 1：必须调用 next()

注意事项 2：中间件的执行顺序很重要

注意事项 3：局部中间件的使用

注意事项 4：统一处理 404

注意事项 5：使用错误处理中间件

3. 总结

在Node.js的Express框架中，中间件是处理请求和响应的关键组件，它可以用于日志记录、权限验证、错误处理等任务。使用中间件时，有一些重要的注意事项需要了解，以确保代码的稳定性和可维护性。下面，我们详细介绍5个注意事项，并提供示例代码帮助理解。

1. 目录结构

/your-project├── app.js                # 主文件，启动应用├── middleware│   ├── logger.js         # 日志中间件│   ├── auth.js           # 身份验证中间件│   ├── requestTime.js    # 记录请求时间的中间件│   ├── notFound.js       # 404 处理中间件│   ├── errorHandler.js   # 全局错误处理中间件└── package.json          # 项目依赖管理文件

2. 代码实现

注意事项 1：必须调用 `next()`

中间件函数必须调用 next()，否则请求会卡住，无法继续执行下一个中间件或路由处理程序。

// middleware/logger.js
const logger = (req, res, next) => {console.log(`Received ${req.method} request for ${req.url}`);next(); // 必须调用，否则请求不会继续
};module.exports = logger;

在 app.js 中使用：

// app.js
const express = require('express');
const app = express();
const logger = require('./middleware/logger');app.use(logger);app.get('/', (req, res) => {res.send('<h1>Home Page</h1>');
});app.listen(3000, () => {console.log('Server running on http://localhost:3000');
});

运行结果： 访问 http://localhost:3000/ 时，控制台输出：

Received GET request for /

注意事项 2：中间件的执行顺序很重要

Express 按照 app.use() 和 app.get() 的顺序执行中间件，错误的顺序可能导致某些中间件失效。

// middleware/requestTime.js
const requestTime = (req, res, next) => {req.requestTime = new Date();next();
};module.exports = requestTime;

在 app.js 中：

const requestTime = require('./middleware/requestTime');app.use(requestTime);app.get('/time', (req, res) => {res.send(`<h1>Request received at: ${req.requestTime}</h1>`);
});

访问 http://localhost:3000/time，页面会显示请求的时间。

注意事项 3：局部中间件的使用

中间件不一定要全局生效，可以局部应用于特定路由，以减少不必要的开销。

// middleware/auth.js
const auth = (req, res, next) => {if (req.query.auth === 'true') {next(); // 通过认证} else {res.status(403).send('<h1>Access Denied</h1>');}
};module.exports = auth;

在 app.js 中：

const auth = require('./middleware/auth');app.get('/dashboard', auth, (req, res) => {res.send('<h1>Welcome to the Dashboard</h1>');
});

访问 http://localhost:3000/dashboard?auth=true 显示：

Welcome to the Dashboard

访问 http://localhost:3000/dashboard 显示：

Access Denied

注意事项 4：统一处理 404

如果没有匹配的路由，应该使用一个中间件来返回 404，避免请求进入死循环。

// middleware/notFound.js
const notFound = (req, res) => {res.status(404).send('<h1>404 - Not Found</h1>');
};module.exports = notFound;

在 app.js 末尾添加：

const notFound = require('./middleware/notFound');app.use(notFound);

访问不存在的路由，如 http://localhost:3000/unknown，页面显示：

404 - Not Found

注意事项 5：使用错误处理中间件

Express 提供了一个特殊的错误处理中间件，必须使用 err, req, res, next 作为参数。

// middleware/errorHandler.js
const errorHandler = (err, req, res, next) => {console.error(`Error: ${err.message}`);res.status(500).send('<h1>Internal Server Error</h1>');
};module.exports = errorHandler;

在 app.js 中：

const errorHandler = require('./middleware/errorHandler');app.get('/error', (req, res, next) => {const err = new Error('Something went wrong!');next(err); // 触发错误处理
});app.use(errorHandler);

访问 http://localhost:3000/error，页面显示：