AI Agent / 系统课时
集成第三方服务
集成第三方服务
第三方服务接入的关键不是完成一次请求,而是让调用在网络波动、服务异常和流量压力下仍然可控。本节将通过认证、超时、重试、限流和降级设计可靠的外部调用方案。
学习目标
- 理解第三方服务调用中的主要风险和治理方式
- 掌握带认证、超时和重试策略的接口调用实现
- 学会通过限流与降级保护自身系统稳定性
第三方服务调用的核心风险
外部服务不属于当前系统控制范围,网络延迟、接口变更、服务不可用都会影响业务。因此集成设计需要把外部依赖视为可能失败的资源,而不是普通函数调用。
常见风险包括认证失效、请求超时、响应异常、访问频率超过限制,以及第三方服务整体不可用。可靠调用的目标是在失败发生时保持系统可预测。
设计可靠调用链路
一个完整调用链通常包含身份验证、请求发送、结果处理和异常恢复。认证负责证明调用者身份,超时避免请求无限等待,重试处理临时故障,降级保证核心业务继续运行。
下面以 JavaScript 服务调用为例,展示一个包含超时和有限重试的调用封装。
js
async function requestWithRetry(url, token, maxRetry = 2) {
for (let attempt = 0; attempt <= maxRetry; attempt++) {
try {
const response = await fetch(url, {
headers: {
Authorization: `Bearer ${token}`
},
signal: AbortSignal.timeout(3000)
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}`);
}
return await response.json();
} catch (error) {
if (attempt === maxRetry) {
throw error;
}
}
}
}预期结果
text
请求成功时返回第三方服务 JSON 数据;连续失败超过重试次数后抛出最终错误。限流与降级策略
重试不能无限增加,否则会在第三方故障时放大压力。系统通常需要结合限流控制请求数量,并通过降级返回缓存数据、默认结果或友好提示。
例如支付、登录等关键流程应优先保证准确性,而推荐、统计等非核心功能可以允许暂时返回缓存结果。不同业务需要选择不同降级方式。
按自己的节奏,确认真正理解。