服务调用失败时怎么办

使用 fetch 设置调用超时,区分业务数据不存在、依赖服务不可用和请求超时,并通过故障实验验证结果。

🎯 引言

前面我们已经让 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');
});

代码看起来比原来长,但这次只增加了两项能力:

  1. 等待超时:read() 给每次 fetch() 设置 800 毫秒的上限,超时返回 504。
  2. 错误分类:查询的订单不存在时返回 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。

三种实验的结果可以汇总为:

操作状态码响应错误码
查询不存在的订单404ORDER_NOT_FOUND
停止用户服务502UPSTREAM_UNAVAILABLE
用户服务延迟 1200 毫秒504UPSTREAM_TIMEOUT
恢复正常用户服务200无,返回订单详情

**提示:**这些是按照本篇给出的代码和本地运行条件应得到的结果。如果某个服务未启动、端口被其他程序占用,或请求经过其他入口,结果可能不同。排查时先直接请求对应业务服务,再请求 BFF。


⚠️ 服务调用失败后,能直接重试吗

不一定。要区分请求是否适合重复执行。

例如,查询用户详情的 GET 请求通常不会修改数据,遇到短暂的网络故障时,可以考虑有次数限制的重试。但订单不存在这样的确定结果,反复请求一般没有帮助。

创建订单的 POST 请求则不同:超时可能只是响应没能送到调用方,订单实际上已经创建成功。 如果马上再次发送相同请求,就可能创建重复订单。

因此,本篇不自动重试。实际项目需要结合具体操作设计安全的重试规则,写操作尤其需要考虑重复提交的问题。


❓ 知识问答

Q1:请求超时,是否说明用户服务没有执行请求?

不是。超时只说明调用方没能在规定时间内拿到结果。服务端可能仍在处理,甚至已经处理完成。

Q2:为什么订单不存在返回 404,而用户服务停止返回 502?

订单不存在是一次已完成的业务查询结果;用户服务停止则表示依赖调用失败,BFF 无法确认用户数据。把它们都返回 404,会让前端误判订单不存在。


🧪 小练习

按照本篇示例,独立完成三次验证:

  1. 请求 /bff/orders/missing,记录状态码和错误码。
  2. 停止用户服务,再请求 /bff/orders/o1,记录状态码和错误码。
  3. 用 DELAY_MS=1200 启动用户服务,再请求 /bff/orders/o1,记录状态码和错误码。

**验收标准:**三次依次得到 404 / ORDER_NOT_FOUND、502 / UPSTREAM_UNAVAILABLE、504 / UPSTREAM_TIMEOUT。最后正常重启用户服务,确认 BFF 恢复返回 200,并能说明三种失败为什么不能用同一个错误表示。


🎉 你已经学会为 HTTP 服务调用设置超时,区分业务数据不存在、依赖服务故障与请求超时,并通过实际实验验证它们!