服务之间如何通过 HTTP 协作

让订单服务通过 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' }

这段代码只有三个必要步骤:

  1. fetch(url) 向用户服务发送 HTTP 请求,并等待响应。
  2. response.ok 检查响应是否成功。需要注意,HTTP 404、500 并不会让 fetch() 自动抛错,所以要主动判断。
  3. 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. 验证正常协作。 启动用户、商品、订单三个服务,提交数量为 1 的合法订单。检查响应是否为 201,totalCents 是否为 29900,再通过订单查询接口确认记录已经创建。
  2. 验证服务依赖。 停止用户服务,再提交合法订单。观察是否返回 502;重新启动用户服务后再请求,确认能够恢复。解释为什么用户服务未启动时,不能直接认定用户不存在。

自查时,你应该能够说清楚:订单服务向谁发请求、为什么需要等待结果,以及什么条件下才会真正保存订单。


🎉 你已经学会让订单服务通过 HTTP 调用用户和商品服务,并在取得业务数据后完成订单创建!