服务调用失败时怎么办
🎯 引言
前面我们已经让 BFF 通过 HTTP 查询订单、用户和商品。三个服务正常运行时,订单详情页可以得到完整的数据。
但如果用户服务突然停止,或者迟迟没有响应呢?BFF 不能一直等待,也不能把“用户服务无法访问”误认为“订单不存在”。
本篇沿用前面的 Express + fetch() 示例,不更换项目结构。我们将为 BFF 的请求设置超时,区分不同失败原因,并亲自模拟故障,观察接口返回什么。
⚠️ 服务调用失败时,应该区分哪些情况
仍以查询 /bff/orders/o1 为例。BFF 要先获取订单,再根据订单中的 ID 查询用户和商品。不同位置失败,含义也不同:
| 场景 | 含义 | 本篇返回的状态码 |
|---|---|---|
| 订单服务明确返回“订单不存在” | 请求的订单确实没有找到 | 404 |
| 订单存在,但关联的用户或商品找不到 | 页面需要的数据不完整,依赖关系出现问题 | 502 |
| 用户或商品服务无法连接、返回服务端错误 | BFF 无法正常取得下游结果 | 502 |
| 下游超过等待时间 | BFF 等不到结果,主动停止等待 | 504 |
404 和 502 不能混为一谈。 订单服务正常响应“没有这张订单”,与用户服务根本没有启动,是两回事。
502 Bad Gateway 和 504 Gateway Timeout 常用于表示下游服务调用失败。本篇让 BFF 按这一约定返回错误,以方便学习;具体业务的状态码仍需结合接口契约决定。
🛠 使用 AbortSignal.timeout() 限制等待时间
前面 BFF 的请求函数是直接使用 fetch():
const response = await fetch('http://127.0.0.1:4001/users/u1');
const user = await response.json();
如果下游响应很慢,这段代码就会一直等待较长时间。我们可以给请求设置一个等待上限:
const response = await fetch('http://127.0.0.1:4001/users/u1', {
signal: AbortSignal.timeout(800),
});
const user = await response.json();
AbortSignal.timeout(800) 的含义是:这次请求最多允许等待约 800 毫秒。超出时间后,信号会中止请求,fetch() 或读取响应正文的过程会抛出异常。这里的 800 只是为了让本地实验容易观察,并非生产环境的通用超时时间。
注意:fetch() 遇到 HTTP 404 或 500 时,通常不会自动抛出异常。 我们仍然需要检查 response.ok,才能区分“对方正常返回一个错误状态”与“请求根本没能完成”。
另外,超时不等于撤销服务端已经做过的操作。调用方不再等待,服务端仍可能已经处理请求。这一点在创建订单等写操作中尤其重要。
🛠 在 BFF 中区分订单不存在、服务故障与超时
现在修改前面《从单体应用到多服务架构》中的 bff.mjs。继续使用三个固定地址:用户服务 4001、商品服务 4002、订单服务 4003;BFF 自己仍监听 4000。
下面给出完整的 bff.mjs,可以直接替换旧文件。它保留了订单聚合功能,也支持前面《BFF 的接口适配与职责边界》介绍的 view=mobile 和 view=desktop。
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',
};
// 给错误附上状态码与业务错误码,便于统一处理。
function createError(status, code) {
return Object.assign(new Error(code), { status, code });
}
// 调用指定业务服务,并限制最长等待时间。
async function read(service, path) {
let response;
try {
response = await fetch(`${services[service]}${path}`, {
signal: AbortSignal.timeout(800),
});
// 404 表示下游明确告知:记录不存在。
// 由调用方决定这在当前业务中意味着什么。
if (response.status === 404) {
throw createError(404, 'RESOURCE_NOT_FOUND');
}
if (!response.ok) {
throw createError(502, 'UPSTREAM_ERROR');
}
return await response.json();
} catch (error) {
// 保留上面已经明确分类的 HTTP 错误。
if (error.status) throw error;
// 超过本次调用的等待上限。
if (error.name === 'TimeoutError') {
throw createError(504, 'UPSTREAM_TIMEOUT');
}
// 连接失败、响应异常或 JSON 无法解析等情况。
throw createError(502, 'UPSTREAM_UNAVAILABLE');
}
}
app.get('/bff/orders/:id', async (req, res) => {
const view = req.query.view ?? 'desktop';
if (!['mobile', 'desktop'].includes(view)) {
return res.status(400).json({ error: 'INVALID_VIEW' });
}
// 1. 先查询订单;订单明确不存在时,对前端返回 404。
let order;
try {
order = await read('orders', `/orders/${encodeURIComponent(req.params.id)}`);
} catch (error) {
if (error.status === 404) {
throw createError(404, 'ORDER_NOT_FOUND');
}
throw error;
}
// 2. 订单存在,再并发查询用户和商品。
// 若关联记录缺失,说明无法完成页面聚合,不是订单不存在。
let user;
let product;
try {
[user, product] = await Promise.all([
read('users', `/users/${encodeURIComponent(order.userId)}`),
read('products', `/products/${encodeURIComponent(order.productId)}`),
]);
} catch (error) {
if (error.status === 404) {
throw createError(502, 'UPSTREAM_ERROR');
}
throw error;
}
// 3. 成功取得数据后,保持前面文章约定的页面响应。
const summary = {
id: order.id,
customerName: user.name,
productName: product.name,
totalCents: order.totalCents,
};
if (view === 'mobile') {
return res.json(summary);
}
res.json({
...summary,
quantity: order.quantity,
user: { id: user.id, name: user.name },
});
});
// Express 5 能把异步路由中抛出的错误交给这个中间件。
app.use((error, req, res, next) => {
const status = error.status ?? 500;
const code = error.code ?? 'INTERNAL_ERROR';
// 内部详情留给服务日志;前端只接收约定的错误码。
console.error('[BFF]', code, error.message);
res.status(status).json({ error: code });
});
app.listen(4000, '127.0.0.1', () => {
console.log('bff on 4000');
});
代码看起来比原来长,但这次只增加了两项能力:
- 等待超时:
read()给每次fetch()设置 800 毫秒的上限,超时返回504。 - 错误分类:查询的订单不存在时返回
404;关联数据缺失、连接失败或下游异常时返回502。
为什么下游的 404 不能直接统一转发?因为同一个下游状态,在不同业务位置有不同含义:订单接口返回 404,说明目标订单不存在;用户接口返回 404,说明已有订单关联的用户数据缺失。我们要根据当前业务判断如何向前端表达,而不是机械复制下游状态码。
🧪 模拟故障,验证 404、502 和 504
先确认商品、订单服务正常运行:
node products.mjs
node orders.mjs
两个命令应在不同终端执行。如果服务已经运行,无须重复启动。修改后的 BFF 也需要重新启动:
node bff.mjs
建议这一组实验直接请求 4000 端口,先排除统一 API 入口的干扰。前面创建的 gateway.mjs 不需要修改。
1. 订单不存在:返回 404
确保订单服务正在运行,然后执行:
curl -i http://127.0.0.1:4000/bff/orders/missing
预期响应状态为 HTTP 404,正文是:
{
"error": "ORDER_NOT_FOUND"
}
这说明 BFF 成功访问了订单服务,并得到明确的“订单不存在”结果。
2. 用户服务停止:返回 502
在运行 users.mjs 的终端按 Ctrl + C,停止用户服务。保持订单、商品服务和 BFF 运行,然后执行:
curl -i http://127.0.0.1:4000/bff/orders/o1
预期状态为 HTTP 502:
{
"error": "UPSTREAM_UNAVAILABLE"
}
订单 o1 仍然存在,只是 BFF 无法连接用户服务,因此不能返回完整的订单详情。此时不应该返回 ORDER_NOT_FOUND。
3. 用户服务太慢:返回 504
为了稳定地模拟慢请求,需要给前面的 users.mjs 增加一小段可配置的延迟。将它替换为下面的代码:
import express from 'express';
import { users } from './data.mjs';
const app = express();
app.get('/users/:id', async (req, res) => {
// 仅用于本地实验,模拟用户服务处理缓慢。
const delay = Number(process.env.DELAY_MS ?? 0);
if (delay > 0) {
await new Promise(resolve => setTimeout(resolve, delay));
}
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');
});
在用户服务的终端启动它,让每次请求延迟约 1200 毫秒:
DELAY_MS=1200 node users.mjs
再次执行:
curl -i http://127.0.0.1:4000/bff/orders/o1
由于 BFF 给用户请求设置了约 800 毫秒的等待上限,预期返回 HTTP 504:
{
"error": "UPSTREAM_TIMEOUT"
}
这说明用户服务没有及时响应,并不代表用户不存在。停止这个慢进程后,正常启动用户服务:
node users.mjs
再访问同一订单,应恢复 HTTP 200,返回订单详情 JSON。恢复用户服务不需要重启 BFF。
三种实验的结果可以汇总为:
| 操作 | 状态码 | 响应错误码 |
|---|---|---|
| 查询不存在的订单 | 404 | ORDER_NOT_FOUND |
| 停止用户服务 | 502 | UPSTREAM_UNAVAILABLE |
| 用户服务延迟 1200 毫秒 | 504 | UPSTREAM_TIMEOUT |
| 恢复正常用户服务 | 200 | 无,返回订单详情 |
**提示:**这些是按照本篇给出的代码和本地运行条件应得到的结果。如果某个服务未启动、端口被其他程序占用,或请求经过其他入口,结果可能不同。排查时先直接请求对应业务服务,再请求 BFF。
⚠️ 服务调用失败后,能直接重试吗
不一定。要区分请求是否适合重复执行。
例如,查询用户详情的 GET 请求通常不会修改数据,遇到短暂的网络故障时,可以考虑有次数限制的重试。但订单不存在这样的确定结果,反复请求一般没有帮助。
创建订单的 POST 请求则不同:超时可能只是响应没能送到调用方,订单实际上已经创建成功。 如果马上再次发送相同请求,就可能创建重复订单。
因此,本篇不自动重试。实际项目需要结合具体操作设计安全的重试规则,写操作尤其需要考虑重复提交的问题。
❓ 知识问答
Q1:请求超时,是否说明用户服务没有执行请求?
不是。超时只说明调用方没能在规定时间内拿到结果。服务端可能仍在处理,甚至已经处理完成。
Q2:为什么订单不存在返回 404,而用户服务停止返回 502?
订单不存在是一次已完成的业务查询结果;用户服务停止则表示依赖调用失败,BFF 无法确认用户数据。把它们都返回 404,会让前端误判订单不存在。
🧪 小练习
按照本篇示例,独立完成三次验证:
- 请求
/bff/orders/missing,记录状态码和错误码。 - 停止用户服务,再请求
/bff/orders/o1,记录状态码和错误码。 - 用
DELAY_MS=1200启动用户服务,再请求/bff/orders/o1,记录状态码和错误码。
**验收标准:**三次依次得到 404 / ORDER_NOT_FOUND、502 / UPSTREAM_UNAVAILABLE、504 / UPSTREAM_TIMEOUT。最后正常重启用户服务,确认 BFF 恢复返回 200,并能说明三种失败为什么不能用同一个错误表示。
🎉 你已经学会为 HTTP 服务调用设置超时,区分业务数据不存在、依赖服务故障与请求超时,并通过实际实验验证它们!
