NestJS微服务部署GCR后，网关无法通过gRPC调用服务问题

核心问题分析 #

你的场景中Postman能直接调用微服务gRPC接口，但网关调用失败，核心原因是NestJS gRPC客户端未适配Cloud Run的gRPC服务要求：Cloud Run对外提供gRPC服务时使用HTTPS（grpcs），且需要正确配置TLS凭证和HTTP/2选项，同时URL格式不能带协议前缀。

具体解决方案 #

1. 修正微服务客户端配置 #

修改MicroserviceClientModule中的客户端配置，适配Cloud Run的生产环境：

import * as grpc from '@grpc/grpc-js'; // 确保导入grpc模块

@Module({
  imports: [
    ClientsModule.registerAsync({
      clients: [
        {
          name: Microservice.CONTENT,
          imports: [ConfigModule],
          inject: [ConfigService],
          useFactory: (config: ConfigService<EnvironmentVariables>) => {
            const isProduction = config.get('NODE_ENV') === 'production';
            // 移除URL中的协议前缀，只保留域名
            const serviceUrl = config.get<string>('MS_CONTENT_URL').replace(/^https?:\/\//, '');
            
            return {
              transport: Transport.GRPC,
              options: {
                url: serviceUrl,
                package: CONTENT_PACKAGE_NAME,
                protoPath: join(PROTO_FOLDER_PATH, 'content.proto'),
                // 生产环境启用TLS凭证，本地用不安全连接
                credentials: isProduction 
                  ? grpc.credentials.createSsl() 
                  : grpc.credentials.createInsecure(),
                grpcOptions: {
                  // 强制启用HTTP/2，适配Cloud Run的gRPC服务
                  'grpc.http2.enable': true,
                  // 禁用HTTP代理，避免DNS解析问题
                  'grpc.enable_http_proxy': false,
                  // 调整消息大小限制（可选，根据业务需求）
                  'grpc.max_receive_message_length': -1,
                  'grpc.max_send_message_length': -1,
                },
              },
            };
          },
        },
      ],
    }),
  ],
  exports: [ClientsModule],
})
export class MicroserviceClientModule {}

2. 调整环境变量MS_CONTENT_URL格式 #

GCR环境下，直接设置为服务域名即可，不需要协议和端口：

MS_CONTENT_URL=my-microservice-12345asbcdef-ey.a.run.app

（本地环境仍使用localhost:5000）

3. 微服务A的启动配置优化（可选） #

虽然Postman能正常调用，但可以添加HTTP/2相关选项确保兼容性：

async function bootstrap() {
  const PORT = parseInt(process.env.PORT) || 5000;
  const logger = new Logger();

  const microserviceOptions: MicroserviceOptions = {
    transport: Transport.GRPC,
    options: {
      url: `0.0.0.0:${PORT}`,
      package: CONTENT_PACKAGE_NAME,
      protoPath: join(PROTO_FOLDER_PATH, 'content.proto'),
      grpcOptions: {
        'grpc.http2.enable': true,
      },
    },
  };
  const app = await NestFactory.createMicroservice<MicroserviceOptions>(
    ContentModule,
    microserviceOptions,
  );
  await app.listen();
  logger.debug(`Started GRPC server on ${microserviceOptions.options.url}`);
}

4. 额外检查项 #

• 确认Cloud Run服务的容器端口与微服务代码中的PORT一致（默认5000）
• 确保网关和微服务都安装了最新版本的@nestjs/microservices和@grpc/grpc-js，避免版本兼容问题
• 两个服务需处于同一个GCP项目，且未配置VPC限制（你已确认无VPC配置，此条可忽略）

错误原因解释 #

• 带https://前缀的URL会导致gRPC客户端DNS解析失败，因为gRPC客户端的url字段不需要协议前缀
• 不加协议和端口时，客户端默认使用不安全连接（默认端口50051），但Cloud Run的gRPC服务监听443端口，导致连接被取消
• 仅启用HTTP/2但未配置TLS凭证，会与Cloud Run的HTTPS服务出现协议不匹配错误

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