如何在Cloud Run的同一端口运行gRPC服务器与Express服务器

要在单个端口同时运行Express（处理HTTP路由）和gRPC服务（内部微服务通信），核心思路是共享同一个HTTP/2服务器实例——因为gRPC基于HTTP/2协议，而Express可以兼容HTTP/2请求，这样就能让两种服务在同一端口上分流处理不同类型的请求。以下是具体实现方案，完全符合你不想预生成客户端库、倾向动态代码生成的需求：

实现步骤与示例代码 #

1. 依赖准备 #

确保安装最新的gRPC JS库和proto加载器（用于动态解析proto文件）：

npm install express @grpc/grpc-js @grpc/proto-loader

2. 完整代码示例 #

const express = require('express');
const http2 = require('http2');
const grpc = require('@grpc/grpc-js');
const protoLoader = require('@grpc/proto-loader');

// 初始化Express应用，处理外部HTTP路由
const app = express();
app.use(express.json());

// 定义对外暴露的Express路由
app.get('/api/health', (req, res) => {
  res.status(200).json({ status: 'healthy', service: 'express-grpc-combo' });
});

// 动态加载gRPC proto文件（无需预生成代码）
const packageDefinition = protoLoader.loadSync('./path/to/your-service.proto', {
  keepCase: true,
  longs: String,
  enums: String,
  defaults: true,
  oneofs: true
});
// 解析proto包
const serviceProto = grpc.loadPackageDefinition(packageDefinition).your.package.name;

// 实现gRPC服务方法
const grpcServiceImpl = {
  GetInternalData: (call, callback) => {
    // 处理gRPC请求逻辑
    callback(null, { data: 'internal service response', timestamp: Date.now() });
  }
};

// 创建gRPC服务器并注册服务
const grpcServer = new grpc.Server();
grpcServer.addService(serviceProto.YourInternalService.service, grpcServiceImpl);

// 创建HTTP/2服务器，统一处理两种请求
const server = http2.createServer();

// 让Express处理普通HTTP请求（HTTP/1.1或HTTP/2）
server.on('request', app);

// 让gRPC服务器处理带有gRPC标识的HTTP/2请求
server.on('stream', (stream, headers) => {
  // 通过Content-Type判断是否为gRPC请求
  if (headers['content-type']?.startsWith('application/grpc')) {
    grpcServer.handleHttp2Stream(stream, headers);
  }
});

// 启动服务器（适配Cloud Run的PORT环境变量）
const port = process.env.PORT || 8080;
server.listen(port, () => {
  console.log(`Combo server running on port ${port}`);
});

关键说明 #

• 端口共享原理：通过同一个HTTP/2服务器分流请求——普通HTTP请求由Express处理，带有application/grpc Content-Type的请求转发给gRPC服务器处理，避免了端口冲突。
• 动态代码生成：使用@grpc/proto-loader动态加载和解析proto文件，无需提前通过protoc生成客户端/服务端代码，完全满足你的需求。
• Cloud Run适配：直接使用Cloud Run提供的PORT环境变量，无需额外配置端口映射，Cloud Run会自动处理外部流量到该端口的转发。

注意事项 #

• 务必使用@grpc/grpc-js而非旧版grpc包，旧包已废弃且对HTTP/2共享支持不佳。
• 本地测试时，若需要HTTPS，可给http2.createServer传入证书配置；Cloud Run环境下无需额外处理TLS，平台会自动提供证书并终止HTTPS。
• gRPC客户端调用时，确保请求的Content-Type为application/grpc，且路径符合gRPC规范（格式为/[package].[service]/[method]）。

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