NestJS微服务使用express-fingerprint报错：INestMicroservice无use属性

错误"Property 'use' does not exist on type 'INestMicroservice'"的核心原因是：NestJS的GRPC微服务实例并非基于HTTP协议构建，因此不支持Express的use中间件方法。express-fingerprint是专门为HTTP请求设计的中间件，无法直接作用于GRPC微服务。

以下是两种可行的解决思路：

方案一：同时运行HTTP应用与GRPC微服务（适用于需要处理HTTP请求的场景） #

如果你的服务需要同时处理HTTP请求（可使用express-fingerprint）和GRPC请求，可以在同一个启动函数中创建两个独立的应用实例：

async function bootstrap() {
  // 创建HTTP应用并添加express-fingerprint中间件
  const httpApp = await NestFactory.create(AppModule);
  httpApp.use(
    Fingerprint({
      parameters: [
        Fingerprint.useragent,
        Fingerprint.acceptHeaders,
        Fingerprint.geoip,
      ],
    }),
  );
  await httpApp.listen(3000);

  // 创建并启动GRPC微服务
  const microservice = await NestFactory.createMicroservice<MicroserviceOptions>(AppModule, {
    transport: Transport.GRPC,
    options: {
      url: '0.0.0.0:6000',
      package: protobufPackage,
      protoPath: 'node_modules/ecommerce-proto/proto/auth.proto',
    },
  });
  await microservice.listen();
}
bootstrap();

方案二：为GRPC微服务实现自定义指纹生成（推荐用于纯GRPC场景） #

GRPC通过元数据（Metadata）传递类似HTTP头的信息，你可以通过NestJS拦截器手动提取这些信息并生成指纹：

1. 创建指纹拦截器 #

import { Injectable, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
import { Observable } from 'rxjs';
import * as Fingerprint from 'express-fingerprint';
import * as geoip from 'geoip-lite'; // 需自行安装：npm i geoip-lite

@Injectable()
export class FingerprintInterceptor implements NestInterceptor {
  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
    // 获取GRPC上下文的元数据与连接信息
    const grpcContext = context.switchToRpc().getContext();
    const metadata = grpcContext.metadata;
    const clientIp = grpcContext.getPeer().split(':')[0];

    // 构造指纹所需参数
    const fingerprintParams = {
      useragent: metadata.get('user-agent')?.[0] || '',
      acceptHeaders: metadata.get('accept')?.[0] || '',
      geoip: geoip.lookup(clientIp),
    };

    // 生成指纹
    const fingerprint = Fingerprint.utils.getFingerprint({
      parameters: [
        () => fingerprintParams.useragent,
        () => fingerprintParams.acceptHeaders,
        () => fingerprintParams.geoip,
      ],
    })({ headers: fingerprintParams });

    // 将指纹附加到请求上下文，供后续业务逻辑使用
    context.switchToRpc().getRequest().fingerprint = fingerprint;

    return next.handle();
  }
}

2. 全局注册拦截器 #

在AppModule中注册拦截器，使其作用于所有GRPC请求：

import { Module } from '@nestjs/common';
import { APP_INTERCEPTOR } from '@nestjs/core';
import { FingerprintInterceptor } from './fingerprint.interceptor';

@Module({
  providers: [
    {
      provide: APP_INTERCEPTOR,
      useClass: FingerprintInterceptor,
    },
  ],
})
export class AppModule {}

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