从单体应用到多服务架构

把单进程模拟后端拆成三个职责清晰、可独立运行的 Express 服务。

🎯 引言

前面的订单案例中,用户、商品和订单接口都由 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 服务,并通过实际测试理解了服务之间的依赖关系!