从单体应用到多服务架构
🎯 引言
前面的订单案例中,用户、商品和订单接口都由 mock.mjs 提供,运行在 4100 端口。即使只修改用户接口,也需要重启这个进程。
如果希望用户、商品和订单功能可以分别启动、停止和更新,该怎么做?本篇继续使用已有的订单数据,将原来的模拟后端拆成 三个独立的 Express 服务,再让 BFF 访问它们。完成后,你将能够理解单体与多服务的区别,亲手完成拆分,并验证服务之间的依赖关系。
🧱 单体应用与多服务架构有什么区别
单体应用是指多个业务功能运行在同一个应用进程中。即使将路由分别写在 users-router.mjs、orders-router.mjs 中,只要最终都由同一个 Express 应用启动,它仍然是单体应用。将代码拆成文件或模块,不等于将应用拆成服务。
拆分前,三个接口都运行在 mock.mjs 的同一进程中,共用端口 4100:
正在加载流程图…
拆分后,每个业务都有独立的启动文件、进程和端口:
正在加载流程图…
现在,停止用户服务不会让商品服务的进程停止。但 BFF 的订单详情需要查询用户名,所以用户服务停止时,订单详情仍可能无法正常显示。独立运行并不意味着业务之间完全没有依赖。
多服务不一定就是微服务。 将代码拆成三个进程,只是具备了独立运行的条件。微服务还强调清晰的业务边界、服务自治、数据职责以及独立部署等设计要求。本篇先把最基本的服务拆分讲清楚。
💡 什么时候需要拆成多个服务
并不是项目一大就必须拆分。可以结合具体问题判断:
| 项目情况 | 更合适的选择 |
|---|---|
| 项目较小,功能之间联系紧密,团队也不大 | 优先保留单体应用,合理划分代码模块 |
| 用户功能频繁调整,希望不影响商品服务的运行 | 可以考虑独立部署用户服务 |
| 不同业务的访问量差异明显,需要分别扩容 | 可以考虑拆成不同服务 |
| 不同团队负责不同业务,希望分别发布 | 可以考虑服务拆分,但需要明确接口约定 |
拆分带来独立运行和部署的可能性,也增加了维护多个进程、服务地址、日志和网络故障的成本。是否拆分,要看这些收益是否值得额外付出的成本。
🧩 按业务职责划分用户、商品和订单服务
我们沿用前面的数据,将服务按业务职责拆分,而不是简单地按接口数量拆分。
| 服务 | 负责什么 | 不负责什么 |
|---|---|---|
用户服务 users | 用户资料、用户是否存在 | 计算订单金额 |
商品服务 products | 商品信息、商品当前价格 | 决定已创建订单的历史价格 |
订单服务 orders | 订单记录、数量、下单金额 | 为不同页面调整展示字段 |
| BFF | 调用业务服务,组合页面需要的数据 | 决定订单的实际计价规则 |
真实项目中,各服务还需要明确自己的数据访问边界。例如,BFF 不应该为了拼接订单详情而直接查询用户表、商品表和订单表,否则业务服务修改表结构时,BFF 也可能被迫跟着修改。
为专注于拆分服务,本篇继续使用内存数组,不引入数据库。data.mjs 只是本地示例的初始数据文件:不同 Node.js 进程分别导入后,各自拥有自己的内存数据,它不是跨服务共享数据库的方案。
🛠 将一个 Express 应用拆成三个独立服务
1. 准备项目文件
继续使用前面课程的示例目录。请确认已安装 Node.js 22,并且项目安装了 Express 5(如果还没有安装依赖,先执行 npm install express@5.1.0)。本篇用到以下文件:
backend-architecture-course/
├── data.mjs # 示例数据
├── mock.mjs # 拆分前的模拟后端,本篇不再启动
├── users.mjs # 新:用户服务
├── products.mjs # 新:商品服务
├── orders.mjs # 新:订单服务
└── bff.mjs # 新:连接三个服务的 BFF
如果前面的 data.mjs 已经存在,保持原文件即可;下面是本篇需要的数据:
// data.mjs
export const users = [{ id: 'u1', name: '小林', email: 'lin@example.test' }];
export const products = [{ id: 'p1', name: '机械键盘', priceCents: 29900 }];
export const orders = [
{ id: 'o1', userId: 'u1', productId: 'p1', quantity: 2, totalCents: 59800 },
];
2. 创建用户服务
新建 users.mjs:
import express from 'express';
import { users } from './data.mjs';
const app = express();
app.get('/users/:id', (req, res) => {
const user = users.find(item => item.id === req.params.id);
if (!user) {
return res.status(404).json({ error: 'USER_NOT_FOUND' });
}
res.json(user);
});
app.listen(4001, '127.0.0.1', () => {
console.log('users service on 4001');
});
这里的 express() 创建一个独立应用,app.get() 提供查询用户的接口,app.listen(4001) 让它单独监听 4001 端口。它不需要启动商品或订单服务就可以对外提供用户数据。
3. 创建商品服务和订单服务
新建 products.mjs,只负责商品查询:
import express from 'express';
import { products } from './data.mjs';
const app = express();
app.get('/products/:id', (req, res) => {
const product = products.find(item => item.id === req.params.id);
if (!product) {
return res.status(404).json({ error: 'PRODUCT_NOT_FOUND' });
}
res.json(product);
});
app.listen(4002, '127.0.0.1', () => {
console.log('products service on 4002');
});
再新建 orders.mjs,只负责订单查询:
import express from 'express';
import { orders } from './data.mjs';
const app = express();
app.get('/orders/:id', (req, res) => {
const order = orders.find(item => item.id === req.params.id);
if (!order) {
return res.status(404).json({ error: 'ORDER_NOT_FOUND' });
}
res.json(order);
});
app.listen(4003, '127.0.0.1', () => {
console.log('orders service on 4003');
});
这三个文件的结构很相似,但它们由三个不同的 Node.js 进程运行,各自拥有自己的端口。为了让拆分过程更容易理解,暂时不使用 createApp()、finish() 等公共封装函数。
4. 修改 BFF,让它调用三个地址
之前 minimal-bff.mjs 的三个请求都发往 4100。现在业务接口分布在不同端口,因此需要按服务选择地址。新建 bff.mjs:
import express from 'express';
const app = express();
const services = {
users: 'http://127.0.0.1:4001',
products: 'http://127.0.0.1:4002',
orders: 'http://127.0.0.1:4003',
};
async function read(service, path) {
const response = await fetch(`${services[service]}${path}`);
if (!response.ok) {
throw new Error(`${service} returned ${response.status}`);
}
return response.json();
}
app.get('/bff/orders/:id', async (req, res) => {
const orderId = encodeURIComponent(req.params.id);
const order = await read('orders', `/orders/${orderId}`);
const [user, product] = await Promise.all([
read('users', `/users/${encodeURIComponent(order.userId)}`),
read('products', `/products/${encodeURIComponent(order.productId)}`),
]);
res.json({
id: order.id,
customerName: user.name,
productName: product.name,
totalCents: order.totalCents,
});
});
// 教学用简化处理:上游不可用或返回非成功状态时统一返回 502。
app.use((error, req, res, next) => {
res.status(502).json({ error: 'UPSTREAM_ERROR' });
});
app.listen(4000, '127.0.0.1', () => {
console.log('bff on 4000');
});
这次真正发生变化的是请求地址,而不是聚合规则。 BFF 仍然先取订单,再并发查询用户和商品,最后返回页面需要的字段。Promise.all 的用法已经在《用 Node.js 实现接口聚合》中讲过,这里不重复展开。
本篇的 BFF 仍然采用最小错误处理:上游请求失败时统一返回 502。生产环境还需要考虑超时、日志和区分不同错误,后续《服务调用失败时怎么办》会专门处理。
🧪 启动并验证服务是否真的独立
1. 分别启动四个进程
先关闭之前运行的 mock.mjs、minimal-bff.mjs,避免旧 BFF 占用 4000 端口。然后打开四个终端,分别执行:
# 终端 A:用户服务
node users.mjs
# 终端 B:商品服务
node products.mjs
# 终端 C:订单服务
node orders.mjs
# 终端 D:BFF
node bff.mjs
每个命令会持续运行,因此需要放在不同终端中。接下来在第五个终端执行:
curl http://127.0.0.1:4001/users/u1
curl http://127.0.0.1:4002/products/p1
curl http://127.0.0.1:4003/orders/o1
curl http://127.0.0.1:4000/bff/orders/o1
下面分别是预期的响应正文(为方便阅读,已格式化):
用户接口:
{ "id": "u1", "name": "小林", "email": "lin@example.test" }
商品接口:
{ "id": "p1", "name": "机械键盘", "priceCents": 29900 }
订单接口:
{ "id": "o1", "userId": "u1", "productId": "p1", "quantity": 2, "totalCents": 59800 }
BFF 聚合接口:
{
"id": "o1",
"customerName": "小林",
"productName": "机械键盘",
"totalCents": 59800
}
可以看到,三个业务服务返回各自的数据,BFF 负责把它们组合成页面需要的结果。
2. 停止其中一个服务,观察影响
在运行 users.mjs 的终端按 Ctrl + C,只停止用户服务,不要关闭其他三个进程。再次请求商品接口,仍应成功;请求 BFF 订单详情则会返回 HTTP 502:
curl -i http://127.0.0.1:4000/bff/orders/o1
HTTP/1.1 502 Bad Gateway
...
{"error":"UPSTREAM_ERROR"}
原因是 BFF 虽然能够查到订单与商品,但还需要从用户服务获取用户名。重新运行 node users.mjs 后,不需要重启商品服务、订单服务或 BFF,订单详情就能恢复正常。
| 运行情况 | 用户接口 | 商品接口 | BFF 订单详情 |
|---|---|---|---|
| 所有服务正常 | 正常 | 正常 | 正常 |
| 关闭用户服务 | 无法连接 | 正常 | 失败(502) |
| 关闭商品服务 | 正常 | 无法连接 | 失败(502) |
3. 独立运行不等于可以随意修改接口
如果修改 users.mjs 的内部实现,只需重启用户服务即可,不必重启商品服务。但如果删掉 BFF 正在读取的 name 字段,BFF 就无法正常提供 customerName。因此,服务可以独立运行,服务之间的接口约定仍然需要保持兼容。
❓ 知识问答
Q1:多个服务必须部署在不同服务器上吗?
不需要。本篇三个业务服务和 BFF 全部运行在同一台电脑上,只使用不同端口。是否部署到不同机器,是后续的部署选择。
Q2:一个数据表就应该对应一个服务吗?
不是。拆分依据应该是业务职责,不是数据库表的数量。例如,订单记录和订单计价规则都属于订单业务,不应该为了“一个表一个服务”而机械拆开。
🧪 小练习
在商品服务中增加接口 GET /products/p1/availability,返回:
{ "available": true }
完成后,只重启 products.mjs,验证新接口能访问,且用户接口、订单接口和 BFF 订单详情仍可正常使用。随后关闭商品服务,再分别访问用户接口、订单接口与 BFF 订单详情,记录结果并解释原因。
验收标准: 你能够说明哪个进程被重启、哪些接口仍能工作,以及为什么 BFF 会受到商品服务停止的影响。
🎉 你已经把单进程模拟后端拆成三个可独立运行的 Express 服务,并通过实际测试理解了服务之间的依赖关系!
