Node.js入门指南：使用JavaScript构建后端服务器

一、认识 Node.js：服务器端 JavaScript 的底座

在传统的 Web 开发模式中，前端页面交互使用 JavaScript，而后端通常使用 Java、PHP 或 Python 等独立技术栈。这种跨语言切换要求团队在前后端维护两套不同的语言语法规范与类型模型。

Node.js 并不属于新的编程语言，也不是某个特定的 Web 框架，而是一个让 JavaScript 代码可以直接在操作系统底层执行的高性能运行时。它由 Ryan Dahl 于 2009 年发布，核心引擎采用 Google 的 V8 引擎，底层系统调用则交由 Libuv 跨平台抽象层处理。

理解 Node.js 的关键在于掌握两个底层特征：单线程事件驱动与非阻塞 I/O。传统的多线程 Web 服务器（如早期的 Apache）为每个到来的客户端连接分配一个独立操作系统线程，当遇到文件读写或数据库查询等耗时 I/O 时，该线程将挂起等待，在高并发场景下极易耗尽系统内存与线程调度资源。Node.js 采用单主线程处理用户代码，遇到 I/O 操作时交由系统底层内核或内部线程池异步执行，主线程继续响应其他网络请求，待 I/O 完成后通过事件循环（Event Loop）触发回调函数。

二、搭建第一个原生 HTTP 服务器

在开始编写代码前，请确保操作系统已安装 Node.js。通过终端输入以下命令验证开发环境：

node -v
npm -v

终端应返回对应的版本号（建议使用 Node.js 18.x 或 20.x 等长期支持 LTS 版本）。确认就绪后，我们新建项目文件夹并初始化项目配置：

mkdir my-node-server
cd my-node-server
npm init -y

npm init -y 会在当前目录生成一个基础的 package.json 文件。接下来，在项目根目录下创建 server.js 文件。Node.js 官方内置了强大的 http 模块，无需安装任何外部第三方依赖即可直接构建 Web 服务器：

// 引入 Node.js 内置的 http 核心模块
const http = require('http');

// 定义服务器监听的主机与端口
const HOSTNAME = '127.0.0.1';
const PORT = 3000;

// 创建 HTTP 服务器实例
const server = http.createServer((req, res) => {
  // 设置 HTTP 状态码为 200，并设置响应头为纯文本编码
  res.statusCode = 200;
  res.setHeader('Content-Type', 'text/plain; charset=utf-8');

  // 向客户端发送响应正文并关闭连接
  res.end('你好，Node.js！后端服务器已成功启动并响应请求。\n');
});

// 绑定端口并开始监听传入连接
server.listen(PORT, HOSTNAME, () => {
  console.log(`服务器正在运行，访问地址: http://${HOSTNAME}:${PORT}/`);
});

在终端中执行以下命令启动该服务进程：

node server.js

此时控制台会输出提示信息，且进程将保持常驻状态。打开浏览器访问 http://127.0.0.1:3000，页面将立即显示我们编写的纯文本响应；或者使用终端工具 curl 进行测试：

curl -i http://127.0.0.1:3000

三、处理路由分发与 JSON 数据响应

在实际后端业务中，服务器需要针对不同的访问路径（URL Path）与 HTTP 动词（GET、POST 等）返回不同的数据。此外，RESTful API 普遍使用 JSON 格式进行数据传输。

在 http.createServer 的回调函数中，入参包含两个核心对象：

• req（http.IncomingMessage）：代表请求对象，包含请求路径 req.url、请求方法 req.method、请求头 req.headers 等数据；
• res（http.ServerResponse）：代表响应对象，用于配置状态码 res.statusCode、设置响应头 res.setHeader 以及输出数据体 res.end。

下面的代码演示了如何在原生 Node.js 中实现路由判断、返回 JSON 数据，以及捕获不存在路径的 404 响应：

const http = require('http');

const server = http.createServer((req, res) => {
  // 解析请求方法与路径
  const { method, url } = req;

  // 统一设置响应格式为 JSON
  res.setHeader('Content-Type', 'application/json; charset=utf-8');

  if (method === 'GET' && url === '/api/info') {
    // 基础信息路由
    res.statusCode = 200;
    res.end(JSON.stringify({
      status: 'success',
      serverName: 'Node.js MicroService',
      timestamp: Date.now()
    }));
  } else if (method === 'GET' && url === '/api/users') {
    // 模拟用户列表路由
    res.statusCode = 200;
    const userList = [
      { id: 101, name: 'Alice', role: 'Developer' },
      { id: 102, name: 'Bob', role: 'Designer' }
    ];
    res.end(JSON.stringify({ status: 'success', data: userList }));
  } else {
    // 未匹配到的路由兜底
    res.statusCode = 404;
    res.end(JSON.stringify({
      status: 'error',
      message: `未找到请求的路径: ${method} ${url}`
    }));
  }
});

server.listen(3000, () => {
  console.log('路由演示服务器运行于: http://localhost:3000');
});

四、工程化演进：使用 Express 框架提升开发效率

虽然原生 http 模块足以胜任简单的原型构建，但在复杂的企业级应用中，继续手动维护多层 if-else 路由分支会导致代码难以阅读与维护。同时，请求体解析（Body Parsing）、静态资源托管、跨域处理（CORS）和全局异常捕获等通用逻辑都需要大量重复编码。

在 Node.js 生态中，成熟的 Web 框架如 Express、Koa 或 Fastify 应运而生。其中 Express 是最经典、社区积累最丰富的中间件架构框架。我们可以通过 npm 安装 Express：

npm install express

安装完成后，使用 Express 重构上述服务，代码将变得极为清晰整洁：

const express = require('express');
const app = express();
const PORT = 3000;

// 内置中间件：解析 application/json 格式的请求体
app.use(express.json());

// 基础信息接口
app.get('/api/info', (req, res) => {
  res.json({
    status: 'success',
    framework: 'Express',
    uptime: process.uptime()
  });
});

// 支持动态参数的用户查询接口
app.get('/api/users/:id', (req, res) => {
  const userId = req.params.id;
  res.json({
    status: 'success',
    data: { id: userId, username: `user_${userId}` }
  });
});

// 接收 POST 提交数据的创建接口
app.post('/api/users', (req, res) => {
  const newUserData = req.body;
  res.status(201).json({
    status: 'created',
    received: newUserData
  });
});

// 全局 404 处理中间件
app.use((req, res) => {
  res.status(404).json({ error: '404 资源未找到' });
});

app.listen(PORT, () => {
  console.log(`Express 服务已就绪: http://localhost:${PORT}`);
});

Express 引入的核心理念是中间件洋葱模型（Middleware）。每个中间件函数可以依次获取 req、res 对象，并在执行自定义业务逻辑（如鉴权、日志打印）后，调用 next() 将控制权移交下一个处理器，极大地提升了系统的解耦与模块化能力。

五、生产环境部署建议与关键技能全景

当本地开发完成后，将 Node.js 部署到正式生产服务器时，需要注意以下关键工程要素：

• 避免使用裸 node server.js 运行生产服务：若主线程遭遇未捕获的运行时异常，整个进程会直接退出崩溃。生产环境下建议搭配进程管理工具（如 PM2）或 Docker 容器运行，实现自动崩溃重启与集群（Cluster）负载均衡。
• 妥善管理环境变量：不要把数据库密码、加密密钥等敏感配置硬编码在代码中。使用 dotenv 模块或通过系统环境注入 process.env.PORT 与 process.env.DB_HOST。
• 严禁在主线程执行长耗时同步阻塞：例如使用 fs.readFileSync() 读写大文件或执行大循环加解密计算。此类操作会彻底挂起事件循环，导致其他网络并发请求全部卡死超时。

六、总结

通过本文的学习，我们完成了从“前端 JavaScript 开发者”向“全栈后端开发”的初步过渡：

1. 底层原理：掌握了 Node.js 借助 V8 引擎与 Libuv 实现的单线程事件循环与异步非阻塞 I/O 特性；
2. 原生实现：理解了 http.createServer、请求对象 req 与响应对象 res 的工作原理，并亲手编写了可运行的 HTTP 服务与 JSON 路由接口；
3. 工程升级：了解了 Express 框架与中间件模型的价值，学会了如何在清晰的代码结构下处理路由分发和请求体解析；
4. 生产就绪：认识到生产部署中进程保护、环境变量解耦以及非阻塞代码编写的重要性。

熟练掌握这些核心基础后，你可以继续探索与 MySQL/MongoDB 数据库的连接操作、JWT 身份令牌验证，以及构建高并发实时的 WebSocket 应用，充分释放 JavaScript 在服务端的高效开发潜能。