NestJS共享HttpModule：如何为单个模块添加特定请求头？

当然可以，不用重新创建HttpModule实例就能实现，下面是几种实用的方案：

方案一：基于全局Axios实例创建子实例 #

Axios支持通过create()方法基于现有实例生成新的子实例，子实例会完全继承原实例的拦截器、超时时间等配置，同时可以单独添加自定义请求头，不会影响全局实例。

在需要自定义头的模块服务中，注入全局的HttpService，然后创建子实例：

import { Injectable, HttpService } from '@nestjs/common';

@Injectable()
export class YourSpecificService {
  private readonly customAxios;

  constructor(private readonly httpService: HttpService) {
    // 基于全局实例创建子实例，添加专属请求头
    this.customAxios = this.httpService.axiosRef.create({
      headers: {
        'X-Module-Exclusive-Header': 'your-custom-value'
      }
    });
  }

  async fetchTargetData() {
    // 使用子实例发起请求，自动携带自定义头
    return this.customAxios.get('https://your-target-api.com/data');
  }
}

方案二：在全局拦截器中添加条件判断 #

如果希望所有通过该模块发起的请求都自动加头，可以在已有的全局Http拦截器中，根据请求的来源模块动态添加头。

比如通过控制器的元数据或类名来识别目标模块：

import { Injectable, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
import { Observable } from 'rxjs';
import { AxiosRequestConfig } from 'axios';

@Injectable()
export class GlobalHttpInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    const axiosConfig = context.getArgs()[0] as AxiosRequestConfig;
    // 获取当前请求所属的控制器类名（对应模块）
    const controllerName = context.getClass().name;

    // 仅给目标模块的请求添加自定义头
    if (controllerName === 'SpecificModuleController') {
      axiosConfig.headers = {
        ...axiosConfig.headers,
        'X-Module-Exclusive-Header': 'your-custom-value'
      };
    }

    return next.handle();
  }
}

如果需要更精准的标识，可以用@SetMetadata给目标控制器添加自定义元数据，再在拦截器中读取判断。

方案三：包装HttpService创建专属服务 #

在目标模块中创建一个自定义的Http服务，包装全局HttpService的方法，在调用时自动注入自定义请求头：

import { Injectable, HttpService } from '@nestjs/common';

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

  async get(url: string, config?: any) {
    const mergedConfig = {
      ...config,
      headers: {
        ...config?.headers,
        'X-Module-Exclusive-Header': 'your-custom-value'
      }
    };
    return this.httpService.get(url, mergedConfig);
  }

  // 按需包装post、put、delete等其他HTTP方法
}

之后该模块内的服务直接依赖SpecificHttpService即可，无需修改全局配置。

推荐方案一，它既能完全保留全局拦截器，又能灵活控制子实例的自定义配置，不会对其他模块产生任何影响。

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