在Nest.js中实现gRPC服务器SSL认证时遇到类型错误问题

错误根源 #

你混淆了ServerCredentials和ChannelCredentials的用途：

• ServerCredentials 专用于gRPC服务器端的SSL凭证配置
• ChannelCredentials 是给gRPC客户端用的
  Nest的credentials字段标注为any确实容易误导，但实际类型要求严格对应场景。

正确实现步骤 #

1. 导入正确的凭证类
   从@grpc/grpc-js导入服务器专用的ServerCredentials：

   import { ServerCredentials } from '@grpc/grpc-js';
   

2. 创建SSL服务器凭证
   读取本地的证书和密钥文件，生成合法的服务器凭证：

   import * as fs from 'fs';
   
   // 根据实际路径替换证书文件位置
   const sslServerCreds = ServerCredentials.createSsl(
     fs.readFileSync('./ssl/ca.crt'), // 可选：CA根证书，用于验证客户端证书
     [{
       private_key: fs.readFileSync('./ssl/server.key'),
       cert_chain: fs.readFileSync('./ssl/server.crt'),
     }],
     false // 设为true则要求客户端提供证书，按需开启
   );
   

3. 在Nest服务器配置中使用
   在main.ts启动gRPC微服务时，将生成的凭证传入options.credentials：

   import { NestFactory } from '@nestjs/core';
   import { AppModule } from './app.module';
   import { MicroserviceOptions, Transport } from '@nestjs/microservices';
   import { ServerCredentials } from '@grpc/grpc-js';
   import * as fs from 'fs';
   
   async function bootstrap() {
     const grpcServer = await NestFactory.createMicroservice<MicroserviceOptions>(AppModule, {
       transport: Transport.GRPC,
       options: {
         package: 'your_service_package', // 对应proto文件里的package名
         protoPath: './src/proto/your_service.proto', // proto文件路径
         url: '0.0.0.0:50051',
         credentials: sslServerCreds // 这里必须传ServerCredentials实例
       },
     });
     await grpcServer.listen();
   }
   bootstrap();
   

避坑提醒 #

• 绝对不要把客户端用的ChannelCredentials.createSsl()传给服务器配置，这是你触发错误的直接原因
• 确保证书文件路径正确，文件读取失败会导致凭证实例无效，进而抛出类似错误
• 如果不需要客户端认证，createSsl的第一个参数（CA证书）可以传null，第三个参数设为false

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