部署在Cloud Run的Java gRPC服务无法调用，求排查建议

核心问题：客户端连接配置错误 #

Cloud Run对外暴露的gRPC服务依赖HTTPS（HTTP/2）传输，你的客户端当前使用明文连接8080端口的方式不符合Cloud Run的要求，这是最可能的原因。

修复与排查步骤 #

1. 修正客户端连接代码

Cloud Run的gRPC服务仅通过443端口对外提供TLS加密访问，客户端必须使用TLS连接，不能用明文。修改代码如下：

// 方式1：使用forTarget自动处理默认443端口和TLS
ManagedChannel channel = ManagedChannelBuilder.forTarget("xxxxx.a.run.app")
    .useTransportSecurity()
    .build();

// 方式2：显式指定443端口和TLS
ManagedChannel channel = ManagedChannelBuilder.forAddress("xxxxx.a.run.app", 443)
    .useTransportSecurity()
    .build();

SimpleGrpcServiceBlockingStub grpcStub = SimpleGrpcServiceGrpc.newBlockingStub(channel);

说明：Cloud Run的负载均衡器会将外部443端口的HTTPS请求转发到容器内部的8080端口（你的服务监听端口），因此客户端无需直接访问8080。

2. 验证服务端端口监听逻辑

确保服务端正确读取Cloud Run提供的$PORT环境变量，而非硬编码端口：

// 正确读取PORT环境变量，默认8080作为 fallback
int port = Integer.parseInt(System.getenv().getOrDefault("PORT", "8080"));
Server server = ServerBuilder.forPort(port).addService(this).build();
server.start();
// 添加启动日志便于排查
System.out.printf("gRPC server started on port %d%n", port);

然后查看Cloud Run的容器日志，确认服务启动时输出的端口与配置的容器端口一致。

3. 核对Cloud Run服务配置

• 确认端到端HTTP/2已启用：这是gRPC服务在Cloud Run上运行的必要条件，确保该选项未被误关闭。
• 确认容器端口设置为8080：Cloud Run的容器端口必须与服务内部监听的端口完全匹配。

4. 使用工具验证服务可用性

用grpcurl工具直接测试服务，排除客户端代码问题：

# 替换为你的服务包名、服务名和方法名
grpcurl -d '{}' xxxxx.a.run.app:443 com.example.SimpleGrpcService/HelloMethod

如果工具能正常调用，说明服务本身没问题，问题出在客户端代码；如果工具也失败，检查服务部署日志或Cloud Run的错误报告。

5. 排查网络限制

确认客户端所在网络允许访问443端口的出站请求，部分企业网络可能会封锁HTTPS端口，导致无法连接Cloud Run服务。

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