Node.js 服务器搭建是现代 Web 开发中的核心技能，它允许开发者使用 JavaScript 语言构建高性能、可扩展的后端服务，Node.js 基于 Chrome V8 引擎，采用事件驱动、非阻塞 I/O 模型，特别适合处理高并发请求，本文将详细介绍从环境准备到项目部署的完整流程，帮助开发者快速上手 Node.js 服务器搭建。
环境准备与基础配置
在开始搭建服务器之前，需要确保本地开发环境已正确配置，访问 Node.js 官网（https://nodejs.org/）下载并安装 LTS（长期支持）版本，安装完成后可通过命令行工具输入 node -v 和 npm -v 验证版本，Node.js 安装时会自动附带 npm（Node Package Manager）,用于管理项目依赖。
创建项目目录并初始化 npm 项目,在命令行中执行以下命令：
mkdir my-node-server cd my-node-server npm init -y
该命令会生成 package.json 文件，用于管理项目依赖和脚本，推荐使用 nvm（Node Version Manager）管理多个 Node.js 版本，可通过 nvm install <版本号> 安装指定版本，nvm use <版本号> 切换版本。
选择服务器框架与基础代码实现
虽然 Node.js 原生提供了 http 模块可以创建服务器，但实际开发中更常使用 Express、Koa 或 Fastify 等框架简化开发流程，以 Express 为例，首先通过 npm 安装：
npm install express
在项目根目录创建 server.js 文件,编写以下基础代码：
const express = require('express');
const app = express();
const port = 3000;
app.get('/', (req, res) => {
res.send('Hello, Node.js Server!');
});
app.listen(port, () => {
console.log(`Server is running on http://localhost:${port}`);
});
运行 node server.js，访问 http://localhost:3000 即可看到响应结果，Express 框架提供了路由、中间件、错误处理等功能,显著提升开发效率。
中间件配置与路由管理
中间件是 Express 的核心特性，用于处理请求、响应、错误等逻辑,常用的中间件包括：
express.json()：解析 JSON 格式的请求体express.urlencoded()：解析 URL 编码的请求体cors：处理跨域请求morgan：记录 HTTP 请求日志
安装所需中间件：
npm install cors morgan
在 server.js 中配置中间件：
const cors = require('cors');
const morgan = require('morgan');
app.use(cors());
app.use(morgan('combined'));
app.use(express.json());
路由管理方面，可将不同模块的路由拆分到独立文件，例如创建 routes/users.js：
const express = require('express');
const router = express.Router();
router.get('/', (req, res) => {
res.json({ message: 'Users endpoint' });
});
module.exports = router;
在 server.js 中引入路由：
const userRoutes = require('./routes/users');
app.use('/api/users', userRoutes);
数据库连接与数据操作
大多数服务器需要与数据库交互，以 MongoDB 为例，使用 Mongoose 作为 ODM（对象文档映射）工具,安装依赖：
npm install mongoose
在 server.js 中连接数据库：
const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/mydb', {
useNewUrlParser: true,
useUnifiedTopology: true,
})
.then(() => console.log('MongoDB connected'))
.catch(err => console.error('Connection error:', err));
定义数据模型（models/User.js）：
const mongoose = require('mongoose');
const userSchema = new mongoose.Schema({
name: String,
email: { type: String, unique: true }
});
module.exports = mongoose.model('User', userSchema);
在路由中使用模型进行数据操作：
const User = require('../models/User');
router.post('/', async (req, res) => {
try {
const user = new User(req.body);
await user.save();
res.status(201).json(user);
} catch (err) {
res.status(400).json({ error: err.message });
}
});
错误处理与性能优化
完善的错误处理机制对服务器稳定性至关重要，Express 提供了统一的错误处理中间件：
app.use((err, req, res, next) => {
console.error(err.stack);
res.status(500).json({ error: 'Something went wrong!' });
});
性能优化方面,可采取以下措施：
- 使用 PM2 管理进程：通过
npm install pm2 -g安装 PM2，启动服务器时使用pm2 start server.js,实现进程守护和负载均衡。 - 启用 Gzip 压缩：使用
compression中间件减少传输数据量。 - 静态资源缓存：通过
express.static配置maxAge参数缓存静态文件。
部署与生产环境配置
开发完成后，需将服务器部署到生产环境,常见部署方案包括：
- 云服务器：使用阿里云、腾讯云等平台的 ECS 服务，通过 SSH 连接部署。
- 容器化部署：使用 Docker 打包应用，配合 Docker Compose 管理服务。
- Serverless：通过 AWS Lambda、Vercel 等平台实现无服务器部署。
以 Docker 为例，创建 Dockerfile：
FROM node:16 WORKDIR /app COPY package*.json ./ RUN npm install COPY . . EXPOSE 3000 CMD ["node", "server.js"]
构建并运行容器：
docker build -t my-node-server . docker run -p 3000:3000 my-node-server
相关问答FAQs
Q1: 如何解决 Node.js 中的跨域问题？
A: 跨域问题可通过安装 cors 中间件解决，在 Express 应用中添加 app.use(cors()) 即可允许所有来源的跨域请求，若需限制特定域名，可配置 cors 的 origin 参数，app.use(cors({ origin: 'https://example.com' }))。
Q2: 生产环境中如何提升 Node.js 服务器的性能？
A: 可从多方面优化性能：1) 使用集群模式（Cluster 模块或 PM2）充分利用多核 CPU；2) 启用缓存机制（Redis、Memcached）；3) 优化数据库查询（添加索引、使用连接池）；4) 使用反向代理（Nginx）处理静态资源和负载均衡；5) 压缩响应数据（Gzip、Brotli）。
