服务通信与发现

学会选择微服务同步与异步通信方式,约定服务接口,并理解服务发现、负载均衡与健康检查的协作。

🎯 引言

上一篇中,用户、订单、库存和模拟支付服务已经能够独立运行。但独立运行不等于能完成业务:用户提交订单后,订单服务怎样向库存服务询问结果?如果库存服务以后启动了三个实例,订单服务又该访问哪一个?本篇沿用之前的项目,使用 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 都写进代码,每次扩容或迁移就要修改配置,维护成本会越来越高。

服务发现解决的就是:调用方如何找到某个服务当前可访问的地址或稳定入口。

常见思路有两种:

  1. 通过注册中心发现实例:实例启动后登记自己的地址,调用方或中间代理查询可用实例。例如 Consul、Nacos 等可承担相关职责。
  2. 通过平台提供的稳定服务名访问:例如 Kubernetes Service 可以让调用方使用相对稳定的服务名访问一组 Pod;即使后面的实例发生变化,调用方通常不需要维护每个 Pod 的地址。

例如在 Kubernetes 中,订单服务可以通过 http://inventory:3003 这样的内部服务名访问库存服务(前提是已创建相应的 Service,并且服务名、端口与实际配置一致)。这个地址只用于说明原理;本篇的本地示例仍使用 http://localhost:3003,不需要更改端口或部署平台。

这说明服务发现解决的是“目标在哪里”,而不是要求我们在本篇搭建注册中心或学习 Kubernetes 配置。


⚖️ 发现、健康检查与负载均衡有什么区别

假设三个库存实例中,C 已经故障:

库存实例地址(示意)状态
A10.0.0.11:3003健康
B10.0.0.12:3003健康
C10.0.0.13:3003不健康

一次订单服务请求可能经过这样的过程:

正在加载流程图…

图中的 A、B 是两种可能的选择,并不是一次请求会同时发送给两个实例。 通常情况下,负载均衡会为一次普通 HTTP 请求选择一个健康实例。实例 C 被判断为不健康后不再接收新的分配请求;健康状态如何更新,取决于注册中心、代理或部署平台的实现。

这几个机制分别负责不同的问题:

  • 服务发现:确定库存服务当前有哪些地址,或应该访问哪个稳定入口。
  • 健康检查:判断某个实例是否适合继续接收流量。具体是由注册中心、代理还是部署平台负责,取决于系统架构。
  • 负载均衡:在可以接收流量的实例之间选择一个目标,不一定平均分配,也不保证每个请求总能成功。

在有些架构中,订单服务查询实例列表并自行选择目标,称为客户端发现;在另一些架构中,订单服务只访问一个稳定入口,由代理或平台选择后端实例,称为服务端发现。两种方式的共同目标都是让实例变化不必直接影响业务代码。

发现实例、判断健康、选择实例是不同职责;某个平台可能把这些能力组合在一起提供,但概念不能混为一谈。

💡 在订单系统中应该怎样选择

业务需求通信或寻址方式主要原因
下单时判断能否预留库存同步请求当前订单流程必须获得预留结果
支付确认成功后通知订单服务异步业务事件其他服务可以稍后处理这一业务事实
本地开发只有一个库存实例固定地址 http://localhost:3003简单、容易调试
库存服务部署多个动态实例稳定服务名或注册发现不必在业务代码中写死每个实例的地址

一个业务系统可以同时使用同步请求和异步事件,二者并不是互相替代的关系。如果当前操作必须等另一个服务返回结果,才能作出下一步业务决定,通常优先考虑同步请求;如果是通知已经发生的业务变化,而且允许其他服务稍后处理,可以考虑异步事件。 最终还应结合失败恢复、响应速度和部署环境进行选择。

下一阶段会继续讨论各服务的数据归属,随后逐步实现业务事件和数据一致性问题。


❓ 知识问答

Q1:使用 RabbitMQ 后,是不是就不需要 HTTP 了?

不是。订单需要马上确认库存预留结果时,同步 HTTP 请求仍然很合适;支付结果通知等场景可以选择异步消息。实际系统通常会混合使用。

Q2:服务发现是不是就是负载均衡?

不是。服务发现负责确定服务在哪里,负载均衡负责本次请求使用哪个实例,健康检查则帮助排除不适合接收流量的实例。

Q3:有了服务发现,接口就不会出错了吗?

不会。服务发现主要解决目标定位,不能替代接口契约、超时、幂等、业务错误处理等设计。


🧪 小练习

完成以下操作并核对结果:

  1. 启动 Express 版订单服务和库存服务,请求 /check-inventory-connection,确认返回 connected: true。
  2. 停止库存服务,再次请求,观察订单服务如何返回失败;解释为什么订单服务仍能运行。
  3. 重新启动库存服务,重复请求并确认恢复 connected: true。
  4. 判断“下单预留库存”“支付成功后通知订单”“获取用户资料”分别更适合同步请求还是异步事件,并说明原因。
  5. 假设三个库存实例中只有 A、B 健康,画出订单服务通过稳定入口访问库存实例的流程,标出不应接收新请求的实例。

验收标准:能观察成功、失败、恢复三种结果;区分“HTTP 接口能访问”和“库存预留业务成功”;能说清服务发现、健康检查与负载均衡分别负责什么。


🎉 恭喜你完成本篇学习!你已经能用 Express 验证服务间调用,并理解通信方式与实例发现的选择依据。