Express 中如何实现单服务对接前端时跨多独立服务转发路由并合并响应?
具体实现方案
整体逻辑非常直接:app1作为前端唯一对接的聚合层,在自身的/api/example路由内,并发调用app2、app3的同路径接口,等两个服务的响应全部返回后,按业务规则合并数据,再统一返回给前端即可。
前置准备
先明确三个服务的本地运行地址,比如:
- app1(对接UI):
http://localhost:3000 - app2:
http://localhost:3001 - app3:
http://localhost:3002
如果是Node.js 18及以上版本,全局自带fetch方法,不需要安装任何第三方HTTP请求库就能完成转发;低版本Node可以将示例里的fetch替换为axios这类轻量请求库,核心逻辑完全一致。
app1 路由实现代码
// 定义下游服务地址常量,后续新增服务只需要在这里加配置即可 const DOWNSTREAM_SERVICES = { app2: 'http://localhost:3001', app3: 'http://localhost:3002' } // 用all方法匹配所有请求方式的/api/example路由,兼容GET/POST等不同请求类型 app1.all('/api/example', async (req, res) => { try { // 并发请求两个下游服务的同一路由,禁止串行执行,避免拉长整体响应时间 const downstreamResponses = await Promise.all( Object.values(DOWNSTREAM_SERVICES).map(serviceBase => { return fetch(`${serviceBase}/api/example`, { method: req.method, // 透传原有请求头,同时修正host头适配下游服务 headers: { ...req.headers, host: new URL(serviceBase).host }, // 非GET请求时透传前端请求体,GET请求自动留空 body: ['POST', 'PUT', 'PATCH'].includes(req.method) ? JSON.stringify(req.body) : undefined }) }) ) // 解析两个服务返回的JSON数据 const [dataApp2, dataApp3] = await Promise.all( downstreamResponses.map(resp => resp.json()) ) // 按你的业务规则合并数据,这里仅做示例 const mergedResult = { app2Data: dataApp2, app3Data: dataApp3, mergeTime: Date.now() } // 将合并后的数据返回给前端 res.json({ code: 200, data: mergedResult }) } catch (error) { console.error('聚合接口调用下游服务失败:', error) res.status(500).json({ code: 500, message: '系统繁忙,请稍后重试' }) } })
几个必须注意的坑
- 转发时一定要修正
host头:直接透传前端传来的host值(比如前端请求的是localhost:3000的),下游服务可能会因为Host头校验不通过拒绝请求,所以需要把转发请求的host头替换成对应下游服务的实际host。 - 做好灵活的错误兜底:如果业务允许部分下游服务故障时也能返回有效数据,可以把
Promise.all换成Promise.allSettled,单独判断每个请求的成功状态,失败的接口可以填充默认值,不要因为单个下游的故障导致整个聚合接口不可用。 - 增加超时控制:原生
fetch没有默认超时,如果下游服务卡死无响应,聚合接口会一直等待请求返回,导致前端超时。可以给每个请求加AbortController做超时中断,比如设置2-3秒的超时阈值。 - 透传必要的请求上下文:比如前端带的鉴权Token、用户ID等请求头,要一并传给下游,否则下游服务无法识别用户身份,可能直接返回401未授权的错误。
内容的提问来源于stack exchange,提问作者BlackMath
相关产品推荐
相关产品推荐

