NestJS微服务中对接第三方API：应置于Service还是Gateway控制器？

核心原则：单一职责 #

NestJS架构遵循关注点分离，先明确两个组件的定位：

• Gateway（网关控制器）：负责对外暴露接口、路由转发、请求校验、流量控制这类边界层工作，是微服务的"入口/出口"。
• Service（业务服务）：封装核心业务逻辑、数据处理、第三方依赖调用，是业务逻辑的"核心实现层"。

最优方案：将第三方API对接逻辑放在Service中 #

把第三方API的调用、参数封装、响应解析、错误处理全部封装在独立的Service里（比如命名为ThirdPartyApiService），优势如下：

• 复用性：其他业务模块需要调用同一第三方API时，直接注入该Service即可，无需重复编写对接逻辑。
• 可测试性：单独对Service编写单元测试，模拟第三方API返回结果，无需依赖网关的请求上下文。
• 解耦性：若第三方API发生变更（如接口地址、参数格式），仅需修改该Service，不会影响网关的路由和校验逻辑。

Gateway只需处理外部请求的接收、参数校验，调用对应Service方法后返回结果给客户端即可。

示例代码片段 #

第三方API Service #

import { Injectable, HttpException } from '@nestjs/common';
import { HttpService } from '@nestjs/axios';
import { catchError, firstValueFrom } from 'rxjs';

@Injectable()
export class ThirdPartyApiService {
  constructor(private readonly httpService: HttpService) {}

  async fetchThirdPartyData(params: Record<string, any>) {
    try {
      const response = await firstValueFrom(
        this.httpService.get('https://third-party-api.com/data', { params })
          .pipe(catchError((error) => {
            throw new HttpException(error.response.data, error.response.status);
          }))
      );
      // 将第三方响应转换为内部业务所需格式
      return this.transformResponse(response.data);
    } catch (error) {
      throw new HttpException('调用第三方API失败', error.status || 500);
    }
  }

  private transformResponse(rawData: any) {
    return {
      id: rawData.id,
      name: rawData.full_name,
      // 其他字段转换逻辑
    };
  }
}

Gateway控制器 #

import { Controller, Get, Query } from '@nestjs/common';
import { ThirdPartyApiService } from './third-party-api.service';

@Controller('api/gateway')
export class GatewayController {
  constructor(private readonly thirdPartyApiService: ThirdPartyApiService) {}

  @Get('fetch-data')
  async fetchData(@Query() queryParams: Record<string, any>) {
    // 此处可添加请求参数校验逻辑
    return this.thirdPartyApiService.fetchThirdPartyData(queryParams);
  }
}

特殊场景的例外情况 #

仅当第三方API对接逻辑完全是无业务处理的纯路由转发时，才考虑直接在Gateway中处理（比如简单的请求代理），但这种场景极少——通常都需要对第三方响应做适配或错误处理，仍建议放在Service中。

内容的提问来源于stack exchange，提问作者Bảo Vỗ