NestJS中如何在非Controller服务内获取前端请求域名

@Headers()是请求上下文绑定的装饰器，仅能在Controller方法入参、请求作用域的Provider中使用。你的LinkService默认是全局单例，Nest启动阶段初始化单例实例时，根本不存在任何请求上下文，自然无法解析@Headers('origin')标记的字符串类型依赖，就会抛出你看到的依赖解析失败错误。

基于Node.js原生AsyncLocalStorage实现全局请求上下文托管，不需要把服务改成请求作用域（会导致单例失效、性能大幅下降），同时满足多模块复用origin的需求。

第一步：安装官方CLS模块 #

Nest官方提供了封装好的异步上下文模块，直接安装即可：

npm install @nestjs/cls

第二步：全局注册CLS中间件 #

在根模块AppModule中注册CLS模块，开启全局中间件自动拦截请求，把请求头里的origin提前存入上下文，同时配置非请求场景的兜底值：

import { Module } from '@nestjs/common';
import { ClsModule } from '@nestjs/cls';

@Module({
  imports: [
    ClsModule.forRoot({
      global: true,
      middleware: {
        mount: true,
        setup: (cls, req) => {
          // 优先取请求头origin，没有则用环境变量配置的默认前端域名
          cls.set('frontendOrigin', req.headers.origin || process.env.DEFAULT_FRONT_ORIGIN);
        },
      },
    }),
    // 其他业务模块
  ]
})
export class AppModule {}

第三步：封装全局通用的Origin获取服务 #

单独封装一个公共服务，统一收口origin的获取逻辑，所有模块需要用前端域名时直接注入该服务即可：

import { Injectable } from '@nestjs/common';
import { ClsService } from '@nestjs/cls';

@Injectable()
export class FrontendOriginService {
  constructor(private readonly cls: ClsService) {}

  getOrigin(): string {
    return this.cls.get('frontendOrigin');
  }
}

把该服务加入根模块的providers数组并设置exports，即可全局注入使用。

第四步：改造原有LinkService #

删掉构造函数里直接注入@Headers('origin')的错误写法，改成注入封装好的公共服务：

import { Injectable } from '@nestjs/common';
import { FrontendOriginService } from './frontend-origin.service';

@Injectable()
export class LinkService {
  constructor(private readonly originService: FrontendOriginService) {}

  createLink1(LinkId1: string): string {
    return `${this.originService.getOrigin()}/linkpath1/${LinkId1}`;
  }

  createLink2(LinkId2: string): string {
    return `${this.originService.getOrigin()}/linkpath2/${LinkId2}`;
  }

  // 其余生成链接的方法逻辑一致
}

• 所有服务保持默认单例模式，不会产生请求作用域级联导致的性能损耗
• origin获取逻辑统一收口，其他任意模块需要前端域名时，直接注入FrontendOriginService调用getOrigin()即可
• 天然兼容非HTTP请求场景：定时任务、消息队列消费等无请求头的场景下，会自动读取环境变量配置的默认域名，不会出现origin为空的问题
• 后续如果需要全局获取请求里的其他公共字段（比如当前登录用户ID、链路追踪ID、语言标识），都可以直接在CLS中间件里扩展，不需要修改各业务服务的注入逻辑

避坑提醒：不要为了获取请求头直接给LinkService加@Injectable({ scope: Scope.REQUEST })标记为请求作用域，所有注入了LinkService的服务都会被级联改成请求作用域，会大幅拉高应用初始化和请求处理的开销，完全没有必要。

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