服务之间如何通过 HTTP 协作
🎯 引言
上一篇《从单体应用到多服务架构》把用户、商品和订单拆成了三个独立的 Express 服务。查询已有订单时,订单服务只需读取自己的订单数据;但创建订单时,它还要确认用户是否存在、商品是否存在,以及商品的价格是多少。
这些信息现在分别由用户服务和商品服务提供。订单服务不能再像调用本地函数一样直接读取另一个进程里的数据。那么,它该怎样获取所需的信息?
本篇沿用上一篇的项目,使用 Node.js 内置的 fetch() 让订单服务通过 HTTP 调用其他服务,最后实现一个可以运行的 POST /orders 接口。
🧱 为什么服务拆分后还需要 HTTP 通信
拆分之前,所有业务可以运行在同一个进程中,订单模块可能直接调用用户模块的函数。拆分之后,用户服务运行在 4001 端口,商品服务运行在 4002 端口,订单服务运行在 4003 端口。三个进程各自运行,内存不共享。
创建订单时,需要经历下面的过程:
正在加载流程图…
这里有两个关键点:
- 订单服务负责创建订单。是否允许创建、订单金额如何计算,都由订单服务决定,不交给 BFF。
- 用户和商品服务负责提供自己的数据。订单服务通过 HTTP 获取信息,而不是跨进程直接访问它们的内存数组。
拆分服务改变的是获取数据的方式,并没有消除业务之间的依赖。
🛠 使用 fetch 调用用户和商品服务
先不急着修改订单接口。我们用最简单的代码观察:一个 Node.js 程序如何请求另一个 HTTP 服务。
保持上一篇的 users.mjs 和 products.mjs 正在运行,在项目目录中新建一个临时文件 test-http.mjs:
const response = await fetch('http://127.0.0.1:4001/users/u1');
if (!response.ok) {
throw new Error(`用户接口请求失败:${response.status}`);
}
const user = await response.json();
console.log(user);
运行:
node test-http.mjs
预期输出:
{ id: 'u1', name: '小林', email: 'lin@example.test' }
这段代码只有三个必要步骤:
fetch(url)向用户服务发送 HTTP 请求,并等待响应。response.ok检查响应是否成功。需要注意,HTTP 404、500 并不会让fetch()自动抛错,所以要主动判断。response.json()将响应中的 JSON 解析为 JavaScript 对象。
如果需要商品信息,只需请求商品服务的地址:
const response = await fetch('http://127.0.0.1:4002/products/p1');
const product = await response.json();
console.log(product);
商品服务正常运行时,会得到:
{ id: 'p1', name: '机械键盘', priceCents: 29900 }
现在已经验证:订单服务也可以使用同样的 fetch() 方式取得用户和商品数据。 临时文件只是为了理解 HTTP 调用,不需要保留在最终项目中。
🛠 在订单服务中实现创建订单
上一篇的 orders.mjs 只有 GET /orders/:id 查询接口。本篇就在这个文件中新增 POST /orders,保留原有查询功能。
创建订单要做四件事:先检查客户端提交的字段,再通过 HTTP 获取用户和商品,确认两者存在后计算金额,最后保存订单。
1. 接收并检查下单参数
客户端提交的数据形如:
{
"userId": "u1",
"productId": "p1",
"quantity": 2
}
订单服务需要先使用 express.json() 解析 JSON 请求体,再检查两个 ID 是否为非空字符串,以及数量是否为 1~99 的整数。不合法就返回 400,没必要继续请求其他服务。
这里不接收客户端提供的 totalCents:成交金额由订单服务根据商品价格计算,不能由客户端自行决定。
2. 查询两个服务并创建订单
将上一篇的 orders.mjs 替换为下面这份完整代码:
import express from 'express';
import { orders } from './data.mjs';
const app = express();
app.use(express.json());
const USERS_URL = 'http://127.0.0.1:4001';
const PRODUCTS_URL = 'http://127.0.0.1:4002';
// 通过 HTTP 查询业务服务。
// 404 表示记录不存在;其他非成功状态交给调用方处理。
async function getData(url) {
const response = await fetch(url);
if (response.status === 404) return null;
if (!response.ok) {
throw new Error(`下游服务返回 ${response.status}`);
}
return response.json();
}
// 保留上一篇的订单详情接口。
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.post('/orders', async (req, res) => {
const { userId, productId, quantity } = req.body ?? {};
if (
typeof userId !== 'string' || !userId.trim() ||
typeof productId !== 'string' || !productId.trim() ||
!Number.isSafeInteger(quantity) || quantity < 1 || quantity > 99
) {
return res.status(400).json({ error: 'INVALID_ORDER' });
}
let user;
let product;
try {
// 两次查询互不依赖,可以同时发起。
[user, product] = await Promise.all([
getData(`${USERS_URL}/users/${encodeURIComponent(userId)}`),
getData(`${PRODUCTS_URL}/products/${encodeURIComponent(productId)}`),
]);
} catch (error) {
// 连接失败,或下游返回其他错误:不能继续创建订单。
console.error('查询业务服务失败:', error);
return res.status(502).json({ error: 'UPSTREAM_ERROR' });
}
if (!user || !product) {
return res.status(422).json({ error: 'INVALID_ORDER_REFERENCE' });
}
const order = {
id: `o${orders.length + 1}`,
userId: user.id,
productId: product.id,
quantity,
totalCents: product.priceCents * quantity,
};
orders.push(order);
res.status(201).json(order);
});
app.listen(4003, '127.0.0.1', () => {
console.log('orders service on 4003');
});
结合刚才的流程图,重点看三个位置:
Promise.all()同时发出用户和商品查询。上一篇接口聚合已经介绍过并发请求,这里只是把它用在业务服务调用其他业务服务的场景中。if (!user || !product)确认两个业务引用都有效。这里的null来自getData()对下游 404 的处理。orders.push(order)放在查询成功之后。只有确认用户、商品都有效,才创建订单;金额使用商品服务返回的priceCents计算。
本例使用内存数组保存订单。它能帮助我们观察协作过程,但重启订单服务后新增记录就会消失;orders.length + 1 也只是单进程的教学用 ID 生成方式,不适合生产环境。
🧪 验证订单服务的 HTTP 协作
保持用户服务和商品服务运行,重启 orders.mjs,使刚才新增的路由生效。BFF 不需要参与这个创建订单实验。
1. 成功创建订单
在另一个终端执行:
curl -i -X POST http://127.0.0.1:4003/orders \
-H 'Content-Type: application/json' \
-d '{"userId":"u1","productId":"p1","quantity":2}'
如果使用上一篇的初始 data.mjs,并且这是订单服务本次启动后第一次成功创建订单,应返回 HTTP 201 Created,响应正文类似:
{
"id": "o2",
"userId": "u1",
"productId": "p1",
"quantity": 2,
"totalCents": 59800
}
商品单价是 29900 分,数量是 2,所以订单金额是 59800 分。之后可以查询新订单:
curl http://127.0.0.1:4003/orders/o2
查询接口应返回刚才创建的订单。注意:如果已经成功创建过其他订单,新订单的 ID 可能不是 o2。
2. 用户不存在时,不创建订单
curl -i -X POST http://127.0.0.1:4003/orders \
-H 'Content-Type: application/json' \
-d '{"userId":"missing","productId":"p1","quantity":2}'
本例返回 HTTP 422:
{
"error": "INVALID_ORDER_REFERENCE"
}
这是因为用户服务正常响应了 404,表示查询的用户不存在。订单服务知道业务数据不满足创建条件,因此拒绝创建,而不是继续保存。
3. 依赖服务不可用时,也不能创建订单
在运行商品服务 products.mjs 的终端按 Ctrl + C,只关闭商品服务,再重新提交合法的创建订单请求:
curl -i -X POST http://127.0.0.1:4003/orders \
-H 'Content-Type: application/json' \
-d '{"userId":"u1","productId":"p1","quantity":2}'
此时本例返回 HTTP 502:
{
"error": "UPSTREAM_ERROR"
}
商品不存在与商品服务无法连接不是一回事。 前者说明我们已经得到业务查询结果;后者说明订单服务根本无法确认商品是否有效,因此不能把它当成“不存在”。
完成实验后重新运行 node products.mjs,恢复商品服务。
⚠️ 服务间 HTTP 调用需要注意什么
这次实践中,客户端只请求订单服务,但订单服务还要等待用户与商品服务返回后,才能完成下单。因此:
- 依赖服务变慢,下单也会变慢。 两个请求可以并发,但订单仍需要等待结果。
- 依赖服务失败,下单就可能失败。 服务能独立启动,不代表所有业务操作都能独立完成。
- 业务数据不存在和服务故障要分开处理。 本例使用 422 表示无效的用户或商品引用,502 表示依赖请求失败;这是当前示例的错误约定。
为了聚焦 HTTP 协作,本篇还没有实现请求超时、重试和更细致的错误分类。后续《服务调用失败时怎么办》会单独介绍这些问题。不要将当前简化实现直接用于生产下单系统。
另外,本例只创建一条内存订单,没有处理扣库存、支付或跨服务事务;多次重复提交成功请求也会创建多条记录。它演示的是如何通过 HTTP 获取其他服务的数据,并不是完整的电商交易方案。
❓ 知识问答
Q1:服务拆分后,订单服务能不能直接 import 用户服务的 data.mjs?
技术上可以导入文件,但这只会让订单进程读取自己的那份数据,不能获得用户服务进程里的实时变化,也会绕过服务的数据职责边界。这里应通过用户服务提供的 HTTP 接口查询。
Q2:为什么创建订单时不让 BFF 直接计算金额?
因为订单金额是业务规则的结果,不只是页面显示格式。BFF 可以为页面整理订单信息,但不能让不同前端各自决定实际成交金额。这里由订单服务查询商品价格并计算、保存订单金额。
🧪 小练习
完成下面两个任务:
- 验证正常协作。 启动用户、商品、订单三个服务,提交数量为
1的合法订单。检查响应是否为 201,totalCents是否为29900,再通过订单查询接口确认记录已经创建。 - 验证服务依赖。 停止用户服务,再提交合法订单。观察是否返回 502;重新启动用户服务后再请求,确认能够恢复。解释为什么用户服务未启动时,不能直接认定用户不存在。
自查时,你应该能够说清楚:订单服务向谁发请求、为什么需要等待结果,以及什么条件下才会真正保存订单。
🎉 你已经学会让订单服务通过 HTTP 调用用户和商品服务,并在取得业务数据后完成订单创建!
