将HttpService从@nestjs/common迁移到@nestjs/axios时遇类型错误

问题根源 #

出现AxiosRequestConfig类型不兼容、method类型不匹配的报错，本质是类型导入来源不一致或axios版本冲突：@nestjs/axios内部依赖的axios版本，和项目中拦截器代码引用的axios类型版本/来源不统一，导致TypeScript判定为不同类型。

具体解决步骤 #

1. 统一所有拦截器的类型导入 #

确保拦截器接口和实现中用到的AxiosRequestConfig、AxiosResponse、Method等类型，全部直接从axios包导入，而非从@nestjs/axios间接导入。

示例拦截器接口定义：

import { AxiosRequestConfig, AxiosResponse } from 'axios';

export interface AxiosInterceptor {
  onRequest(config: AxiosRequestConfig): AxiosRequestConfig | Promise<AxiosRequestConfig>;
  onResponse(response: AxiosResponse): AxiosResponse | Promise<AxiosResponse>;
  onResponseRejected(error: any): any;
}

2. 强制统一axios版本 #

@nestjs/axios对axios有版本依赖，若项目中安装的axios版本和它依赖的版本不一致，会引发类型冲突。可通过包管理器的版本锁定功能强制统一：

• npm用户：在项目根目录的package.json中添加overrides字段：

  "overrides": {
    "axios": "1.6.0" // 替换为@nestjs/axios依赖的axios版本，可查看node_modules/@nestjs/axios/package.json确认
  }
  

• yarn用户：在package.json中添加resolutions字段：

  "resolutions": {
    "axios": "1.6.0"
  }
  

添加后执行npm install或yarn install重新安装依赖。

3. 检查拦截器方法的返回类型 #

确保每个拦截器的onRequest、onResponse方法返回值严格匹配AxiosRequestConfig/AxiosResponse（或对应的Promise），避免返回额外字段或错误类型导致类型校验失败。

临时绕过方案（不推荐长期使用） #

若需快速临时解决，可在调用拦截器方法时添加类型断言：

interceptorManager.request.use((request) =>
  interceptor.onRequest(request as import('axios').AxiosRequestConfig)
);

但这只是绕过TypeScript检查，无法解决根本的版本/类型来源问题。

内容的提问来源于stack exchange，提问作者Krish909