1. Express Web服务工程导论

Express 是 Node.js 生态中最具影响力的 Web 服务框架之一。它并不试图重新发明 HTTP，而是把 Node.js 原生 http 模块中繁琐的请求解析、路由匹配、中间件串联等工作，抽象成一套简洁、可组合的编程接口。理解 Express 的定位，是学习本课程的第一步：它不是“全栈框架”，也不是“企业级全家桶”，而是一个轻量、开放、以中间件为核心的 Web 服务基础层。

在 Node.js 生态中，Express 处于“应用层框架”的位置。底层是 Node.js 运行时与 http/https 模块，负责 TCP 连接、HTTP 报文解析与响应写出；上层则是各类专用中间件与工具，如模板引擎、会话管理、日志、鉴权、数据库访问等。Express 本身只提供路由、中间件机制、请求与响应对象的增强，以及少量内置能力。这种“薄核心 + 厚生态”的设计，使开发者可以按需组合，而不是被框架绑定。

从工程视角看，Web 服务工程的核心关注点并不只是“把接口写出来”，而是围绕可维护、可观测、可扩展、可安全运行四个维度展开。具体包括：路由与资源设计是否清晰；中间件顺序是否正确；请求体、查询参数、路径参数是否被正确解析与校验；错误是否被统一捕获并返回稳定结构；日志是否足以定位问题；配置是否与环境分离；服务是否具备基本的健康检查与优雅退出能力。这些关注点贯穿本课程始终。

本课程以一个“任务管理服务”作为贯穿项目。它足够小，可以在单章内讲清；又足够完整，能覆盖真实 Web 服务的典型要素。项目最终形态包括：基于 Express 的 REST 接口、路由分层、请求校验、统一错误处理、日志中间件、环境配置、静态资源服务、以及一个可运行的测试集合。学习路径按“先跑通、再分层、后加固”推进：先让一个最小服务响应请求，再引入路由与中间件组织代码，然后加入校验、错误处理与日志，最后补充配置、安全与部署相关实践。

下面给出一个最小可运行示例，用于建立对 Express 请求处理链的直观认识。它只做三件事：注册一个日志中间件、注册一个 GET 路由、启动监听。运行后访问 http://localhost:3000/tasks，可以在终端看到请求日志，并在浏览器或接口工具中看到 JSON 响应。

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

// 日志中间件：每个请求都会经过
app.use((req, res, next) => {
  console.log(`${new Date().toISOString()} ${req.method} ${req.url}`);
  next();
});

// 路由：返回任务列表
app.get('/tasks', (req, res) => {
  res.json([
    { id: 1, title: '阅读 Express 文档', done: false },
    { id: 2, title: '搭建最小服务', done: true }
  ]);
});

app.listen(PORT, () => {
  console.log(`Server running at http://localhost:${PORT}`);
});

这段代码体现了 Express 的两个关键机制。第一，中间件按注册顺序执行，日志中间件先于路由处理，因此能记录所有请求；调用 next() 表示把控制权交给下一个匹配的中间件或路由。第二，路由匹配基于方法与路径，app.get('/tasks', handler) 只响应 GET 请求，其他方法不会进入该处理函数。若把日志中间件写在路由之后，则只有未匹配路由的请求才会经过它，这正是中间件顺序重要性的直接体现。

在工程实践中，还需要尽早建立“请求—处理—响应—错误”的完整视角。一个请求进入后，可能经过解析、鉴权、校验、业务处理、序列化等多个阶段；任一阶段都可能失败。Express 通过错误中间件（四个参数：err, req, res, next）集中处理异常。若没有统一错误处理，客户端可能收到默认 HTML 错误页或连接中断，这对 API 服务不可接受。因此，从课程早期就应养成“正常路径与错误路径同时设计”的习惯。

学习本课程时，建议每章都动手运行示例，并观察三个信号：终端日志是否按预期输出；HTTP 状态码与响应体是否符合设计；异常路径是否返回稳定结构。只要这三个信号可观察、可复现，就说明对当前知识点形成了闭环理解。Express 的学习曲线并不陡峭，但工程能力来自对细节的持续打磨。