服务通信与发现
🎯 引言
上一篇中,用户、订单、库存和模拟支付服务已经能够独立运行。但独立运行不等于能完成业务:用户提交订单后,订单服务怎样向库存服务询问结果?如果库存服务以后启动了三个实例,订单服务又该访问哪一个?本篇沿用之前的项目,使用 Express 完成一次可以实际验证的服务调用,再讲清同步与异步通信、接口契约,以及服务发现和负载均衡各自解决的问题。
🧱 同步通信:需要结果才能继续
设想用户购买两件商品。订单服务必须先知道库存是否允许预留,才能决定是否继续创建订单。这时通常采用同步通信:订单服务发送请求,等待库存服务返回结果,再执行下一步。
正在加载流程图…
这里的“同步”指当前业务流程要等待对方的答复,不等于 Node.js 必须用阻塞线程的方式等待。即使用 await fetch(),Node.js 也可以同时处理其他请求。
同步通信适合查询用户信息、判断库存是否足够等需要立即获得结果的场景。它的代价也很直接:如果库存服务响应缓慢,创建订单的过程也会跟着等待。因此,调用方需要设置超时,并区分正常的业务失败与网络故障。重试、熔断和幂等会在后面的“容错与可靠性”中展开。
使用 Express 验证两个服务能够通信
上一章已经使用 Express 建立四个服务,每个服务都有独立的 package.json 和 /health 接口。本节直接沿用项目,只修改订单服务。库存、用户和模拟支付服务的入口代码不变,也不需要重新安装 Express。
编辑 services/orders/src/app.mjs,使用下面的完整代码(Node.js 22.x,Express 5.1.0;fetch 为 Node.js 内置能力):
import express from 'express';
const app = express();
const port = 3002;
const inventoryUrl = 'http://localhost:3003';
app.get('/health', (req, res) => {
res.json({ service: 'orders', status: 'ok' });
});
app.get('/check-inventory-connection', async (req, res) => {
try {
const response = await fetch(`${inventoryUrl}/health`, {
signal: AbortSignal.timeout(1500)
});
if (!response.ok) {
return res.status(502).json({ connected: false, error: '库存服务响应异常' });
}
const inventory = await response.json();
res.json({ connected: true, inventory });
} catch (error) {
console.error('库存服务调用失败:', error.message);
res.status(502).json({ connected: false, error: '库存服务暂时不可用' });
}
});
app.listen(port, () => {
console.log(`orders: http://localhost:${port}`);
});
这里需要理解的只有三点:
inventoryUrl是订单服务在本地演示中访问库存服务的地址,固定使用上一章的3003端口。AbortSignal.timeout(1500)给本次 HTTP 请求设置 1.5 秒超时,防止订单接口一直等待。- 库存服务无法访问或返回异常时,订单服务在这个简化示例中返回 HTTP
502,说明下游调用失败。它与“库存不足”这样的正常业务拒绝不是一回事。
分别打开两个终端,都从项目根目录启动服务:
终端一:
cd services/inventory && npm start
终端二:
cd services/orders && npm start
再打开第三个终端执行:
curl -i http://localhost:3002/check-inventory-connection
预期 HTTP 状态为 200,响应体类似:
{
"connected": true,
"inventory": {
"service": "inventory",
"status": "ok"
}
}
停止库存服务后再次执行同一命令,预期返回 HTTP 502:
{
"connected": false,
"error": "库存服务暂时不可用"
}
这个结果说明订单服务进程仍然活着,但它已经无法访问库存服务。独立运行不等于依赖故障时业务仍然可用。
/health 只是为了验证两个服务之间能通信,不代表已经实现库存预留。后续的业务开发文章才会实现实际库存操作。✨ 异步通信:通知其他服务已经发生的事情
假设支付服务已经确认某笔支付成功。它需要通知订单服务更新状态,但不一定要等待订单服务完成更新后,才继续处理自己的所有工作。
这时可以采用异步事件通信:支付服务发布一个代表业务事实的事件,例如 PaymentSucceeded(支付已成功),由订单服务稍后消费。
正在加载流程图…
这里的事件不是“请帮我查询支付是否成功”的请求,而是“这笔支付已经成功”的通知。事件的接收与处理可以发生在不同时间,因此订单服务暂时不可用时,是否还能收到事件,取决于消息系统的持久化、确认和重试等配置。
你之前已经学过 RabbitMQ,本篇不再重复创建交换机、队列和消费者。这里需要记住的是:
- 同步请求:当前流程需要对方给出答案,才能决定下一步。
- 异步事件:通知其他服务一个已经发生的事实,接收方可以稍后处理。
🧩 接口契约:两个服务必须有共同约定
订单服务通过 HTTP 调用库存服务,不应该直接了解库存服务内部的数据库表。双方需要约定一份接口契约:请求怎么发送、字段代表什么、成功和失败分别返回什么。
以未来的“预留库存”功能为例,可以先设计如下约定,注意:这个接口目前还没有实现。
POST /reservations
Content-Type: application/json
{"orderId":"o-100","sku":"A","quantity":2}
字段含义:orderId 是订单编号,sku 是商品规格编号,quantity 是希望预留的件数。
预留成功时可以约定返回:
{
"reservationId": "r-100",
"status": "reserved"
}
库存不足时则返回明确的业务错误,例如 HTTP 409 和:
{
"code": "INSUFFICIENT_STOCK",
"message": "库存不足"
}
将上面的约定整理起来,就是一份最简单的接口契约:
| 约定项目 | 本课程的设计 |
|---|---|
| 请求方法与路径 | POST /reservations |
| 请求字段 | orderId、sku、quantity |
| 预留成功 | HTTP 201,返回 reservationId 和 status |
| 库存不足 | HTTP 409,返回 INSUFFICIENT_STOCK |
| 服务调用失败 | 网络连接失败、超时或服务端异常,由调用方分别处理 |
这里的 HTTP 201、409 和字段格式只是本课程采用的一种约定,并不是所有库存接口的统一标准。实际实现时,服务双方还需要明确哪些字段必填、有哪些合法取值,以及不同错误应该怎样处理。
接口还需要考虑升级:如果库存服务将 quantity 突然改名为 count,旧版本的订单服务仍发送 quantity,调用就可能失败。比较稳妥的方式是保留旧字段一段时间,或者在确实需要破坏性变更时发布新版本接口。
接口契约让服务依赖公开规则,而不是依赖对方内部代码。 后续的契约测试会检查双方是否仍遵守这些规则。
🔎 服务发现:实例地址变化后,怎么找到服务
目前订单服务通过 http://localhost:3003 找到库存服务。本地只有一个库存实例时,这样非常方便。
但是生产环境中,一个服务可能运行多个实例。实例就是同一个服务程序的一个运行副本。例如库存服务可能运行在:
库存实例 A:10.0.0.11:3003
库存实例 B:10.0.0.12:3003
库存实例 C:10.0.0.13:3003
这些地址只是示例。某个实例重启或迁移后,IP 可能改变。如果订单服务把三个 IP 都写进代码,每次扩容或迁移就要修改配置,维护成本会越来越高。
服务发现解决的就是:调用方如何找到某个服务当前可访问的地址或稳定入口。
常见思路有两种:
- 通过注册中心发现实例:实例启动后登记自己的地址,调用方或中间代理查询可用实例。例如 Consul、Nacos 等可承担相关职责。
- 通过平台提供的稳定服务名访问:例如 Kubernetes Service 可以让调用方使用相对稳定的服务名访问一组 Pod;即使后面的实例发生变化,调用方通常不需要维护每个 Pod 的地址。
例如在 Kubernetes 中,订单服务可以通过 http://inventory:3003 这样的内部服务名访问库存服务(前提是已创建相应的 Service,并且服务名、端口与实际配置一致)。这个地址只用于说明原理;本篇的本地示例仍使用 http://localhost:3003,不需要更改端口或部署平台。
这说明服务发现解决的是“目标在哪里”,而不是要求我们在本篇搭建注册中心或学习 Kubernetes 配置。
⚖️ 发现、健康检查与负载均衡有什么区别
假设三个库存实例中,C 已经故障:
| 库存实例 | 地址(示意) | 状态 |
|---|---|---|
| A | 10.0.0.11:3003 | 健康 |
| B | 10.0.0.12:3003 | 健康 |
| C | 10.0.0.13:3003 | 不健康 |
一次订单服务请求可能经过这样的过程:
正在加载流程图…
图中的 A、B 是两种可能的选择,并不是一次请求会同时发送给两个实例。 通常情况下,负载均衡会为一次普通 HTTP 请求选择一个健康实例。实例 C 被判断为不健康后不再接收新的分配请求;健康状态如何更新,取决于注册中心、代理或部署平台的实现。
这几个机制分别负责不同的问题:
- 服务发现:确定库存服务当前有哪些地址,或应该访问哪个稳定入口。
- 健康检查:判断某个实例是否适合继续接收流量。具体是由注册中心、代理还是部署平台负责,取决于系统架构。
- 负载均衡:在可以接收流量的实例之间选择一个目标,不一定平均分配,也不保证每个请求总能成功。
在有些架构中,订单服务查询实例列表并自行选择目标,称为客户端发现;在另一些架构中,订单服务只访问一个稳定入口,由代理或平台选择后端实例,称为服务端发现。两种方式的共同目标都是让实例变化不必直接影响业务代码。
💡 在订单系统中应该怎样选择
| 业务需求 | 通信或寻址方式 | 主要原因 |
|---|---|---|
| 下单时判断能否预留库存 | 同步请求 | 当前订单流程必须获得预留结果 |
| 支付确认成功后通知订单服务 | 异步业务事件 | 其他服务可以稍后处理这一业务事实 |
| 本地开发只有一个库存实例 | 固定地址 http://localhost:3003 | 简单、容易调试 |
| 库存服务部署多个动态实例 | 稳定服务名或注册发现 | 不必在业务代码中写死每个实例的地址 |
一个业务系统可以同时使用同步请求和异步事件,二者并不是互相替代的关系。如果当前操作必须等另一个服务返回结果,才能作出下一步业务决定,通常优先考虑同步请求;如果是通知已经发生的业务变化,而且允许其他服务稍后处理,可以考虑异步事件。 最终还应结合失败恢复、响应速度和部署环境进行选择。
下一阶段会继续讨论各服务的数据归属,随后逐步实现业务事件和数据一致性问题。
❓ 知识问答
Q1:使用 RabbitMQ 后,是不是就不需要 HTTP 了?
不是。订单需要马上确认库存预留结果时,同步 HTTP 请求仍然很合适;支付结果通知等场景可以选择异步消息。实际系统通常会混合使用。
Q2:服务发现是不是就是负载均衡?
不是。服务发现负责确定服务在哪里,负载均衡负责本次请求使用哪个实例,健康检查则帮助排除不适合接收流量的实例。
Q3:有了服务发现,接口就不会出错了吗?
不会。服务发现主要解决目标定位,不能替代接口契约、超时、幂等、业务错误处理等设计。
🧪 小练习
完成以下操作并核对结果:
- 启动 Express 版订单服务和库存服务,请求
/check-inventory-connection,确认返回connected: true。 - 停止库存服务,再次请求,观察订单服务如何返回失败;解释为什么订单服务仍能运行。
- 重新启动库存服务,重复请求并确认恢复
connected: true。 - 判断“下单预留库存”“支付成功后通知订单”“获取用户资料”分别更适合同步请求还是异步事件,并说明原因。
- 假设三个库存实例中只有 A、B 健康,画出订单服务通过稳定入口访问库存实例的流程,标出不应接收新请求的实例。
验收标准:能观察成功、失败、恢复三种结果;区分“HTTP 接口能访问”和“库存预留业务成功”;能说清服务发现、健康检查与负载均衡分别负责什么。
🎉 恭喜你完成本篇学习!你已经能用 Express 验证服务间调用,并理解通信方式与实例发现的选择依据。
