路由（Routing）是Web服务端开发中最核心的概念之一。简单来说，路由就是根据请求的URL路径和HTTP方法，决定由哪段代码来处理这个请求，并返回对应的响应。很多人用Express时顺手就写了app.get('/user', handler)，却未必清楚这行代码背后发生了什么。本文就从零开始，用原生Node.js实现一个完整的路由系统，把原理彻底讲透。
一、路由的本质是什么
当浏览器向服务器发起一个HTTP请求时，请求中包含三个关键信息：请求方法（GET、POST、PUT、DELETE等）、URL路径（如/user/list）以及查询参数。路由的工作就是拿这三个信息去匹配一张预先定义好的规则表，找到匹配的规则后，执行对应的处理函数。
所以路由的核心数据结构其实很简单，就是一个数组或者Map，每一项记录了方法、路径模式和处理函数。请求进来后遍历这个表，命中则执行，全部未命中则返回404。下面先看一个最基础的原生实现：
const http = require('http');
// 定义路由表
const routes = [
{ method: 'GET', path: '/', handler: (req, res) => {
res.end('首页');
}},
{ method: 'GET', path: '/about', handler: (req, res) => {
res.end('关于我们');
}},
{ method: 'POST', path: '/login', handler: (req, res) => {
res.end('登录处理');
}}
];
const server = http.createServer((req, res) => {
// 解析URL，去掉查询字符串
const pathname = req.url.split('?')[0];
// 遍历路由表寻找匹配项
const route = routes.find(r =>
r.method === req.method && r.path === pathname
);
if (route) {
route.handler(req, res);
} else {
res.statusCode = 404;
res.end('404 Not Found');
}
});
server.listen(3000, () => {
console.log('服务器运行在 3000 端口');
});这段代码虽然简陋，但已经包含了路由系统的全部要素：路由表、匹配逻辑、分发执行和兜底处理。Express的路由本质上也是这样一张表，只是封装得更完善，支持了中间件、路径参数、通配符等高级特性。
二、实现动态路由参数匹配
真实的业务中，路径不可能是固定的。比如/user/123和/user/456应该匹配同一个处理逻辑，只是参数不同。要支持这种动态路径，需要把路径模式转换成正则表达式进行匹配，并把参数提取出来放到req.params对象中。
思路是：定义路径时用:id这样的形式标记参数位，匹配前先把/user/:id编译成正则/^\/user\/([^\/]+)$/，同时记录参数名。请求进来后用正则的捕获组提取实际值。实现如下：
const http = require('http');
const url = require('url');
// 把 /user/:id 编译成正则和参数名列表
function compile(path) {
const keys = [];
const pattern = path.replace(/:([^\/]+)/g, (_, key) => {
keys.push(key);
return '([^\/]+)';
});
return {
regex: new RegExp('^' + pattern + '$'),
keys
};
}
const routeDefs = [
{ method: 'GET', path: '/user/:id', handler: (req, res) => {
res.end('查询用户ID: ' + req.params.id);
}},
{ method: 'GET', path: '/post/:year/:month', handler: (req, res) => {
res.end(`文章归档 ${req.params.year}-${req.params.month}`);
}}
];
// 预编译所有路由
const routes = routeDefs.map(r => ({ ...r, ...compile(r.path) }));
const server = http.createServer((req, res) => {
const pathname = url.parse(req.url).pathname;
for (const route of routes) {
if (route.method !== req.method) continue;
const match = pathname.match(route.regex);
if (match) {
// 提取参数挂到 req.params
req.params = {};
route.keys.forEach((key, i) => {
req.params[key] = decodeURIComponent(match[i + 1]);
});
return route.handler(req, res);
}
}
res.statusCode = 404;
res.end('404 Not Found');
});
server.listen(3000);有几个细节需要注意。第一，参数值必须经过decodeURIComponent解码，否则URL中包含中文或特殊字符时会出现乱码。第二，正则要用^和$锚定首尾，否则/user/123/posts这样的路径也会被/user/:id错误匹配。第三，如果参数只允许数字，可以把:id编译成(\\d+)，在正则层面就过滤掉非法输入，比在业务代码里校验更干净。
三、借鉴Express的路由封装思路
理解了原理之后，再回头看Express的设计就会豁然开朗。Express把路由做成了分层结构：Router对象本身可以挂载子Router，形成路由树，这正是express.Router()实现模块化路由的基础。它还在路由匹配前后插入了中间件链，处理函数可以写成多个，依次执行，通过next()传递控制权。
我们可以给前面的实现加上链式注册和中间件支持，让它更接近一个迷你框架：
class MiniRouter {
constructor() {
this.routes = [];
this.middlewares = [];
}
use(fn) {
this.middlewares.push(fn);
return this; // 支持链式调用
}
get(path, ...handlers) { this.add('GET', path, handlers); return this; }
post(path, ...handlers) { this.add('POST', path, handlers); return this; }
add(method, path, handlers) {
const keys = [];
const pattern = path.replace(/:([^\/]+)/g, (_, key) => {
keys.push(key);
return '([^\/]+)';
});
this.routes.push({
method,
regex: new RegExp('^' + pattern + '$'),
keys,
handlers
});
}
handle(req, res) {
const pathname = req.url.split('?')[0];
const stack = [...this.middlewares];
req.params = {};
const route = this.routes.find(r =>
r.method === req.method && r.regex.test(pathname)
);
if (!route) {
res.statusCode = 404;
return res.end('404 Not Found');
}
const match = pathname.match(route.regex);
route.keys.forEach((key, i) => {
req.params[key] = decodeURIComponent(match[i + 1]);
});
stack.push(...route.handlers);
let idx = 0;
const next = () => {
if (idx >= stack.length) return;
stack[idx++](req, res, next);
};
next();
}
}
// 使用方式与Express几乎一致
const router = new MiniRouter();
router.use((req, res, next) => {
console.log(`${req.method} ${req.url}`);
next();
});
router.get('/user/:id', (req, res, next) => {
if (req.params.id === 'admin') {
return res.end('禁止访问admin');
}
next();
}, (req, res) => {
res.end('用户详情: ' + req.params.id);
});
require('http').createServer((req, res) => router.handle(req, res))
.listen(3000);这个实现展示了路由与中间件的关系：中间件本质上就是不限定路径的通用处理层，而路由是限定了方法与路径的精确处理层，两者最终汇入同一条执行链。Express在匹配路径时使用的是一个叫path-to-regexp的库，它把路径模式编译成正则的能力更强，支持可选参数、通配符、自定义正则约束等写法。
四、路由设计中的常见坑与优化建议
实际项目中，路由层面有几个高频问题值得注意。一是路径尾部斜杠的处理，/user和/user/默认是两个不同的路径，很多团队会统一去掉尾部斜杠或做重定向，避免SEO重复内容问题。二是路由表的匹配顺序，先注册的先匹配，如果把/user/new写在/user/:id之后，new就会被当成id参数捕获，导致永远访问不到预期页面，所以具体路径必须放在动态路径之前注册。
三是性能问题。路由表庞大时，线性遍历的匹配效率会下降。优化手段包括：按HTTP方法把路由分组减少比较次数、用前缀树（Trie）组织路径加速公共前缀匹配、以及启动时预编译正则而不是每次请求时编译。大多数应用的路由数量在几十到几百条，线性遍历其实完全够用，不必过早优化。
最后是安全性方面，永远不要信任路由参数。即使正则限制了id只能是数字，业务层依然要做参数校验和权限校验，路由匹配成功只代表格式正确，不代表这个用户有权访问这条数据。把路由理解为请求分发的入口，把校验和鉴权放在中间件或业务层层层把关，才是健壮的设计。