Cloud Run服务间GRPC调用失败求助

1. 确认gRPC客户端目标地址配置 #

• Cloud Run的gRPC服务必须通过域名+443端口访问，不能省略端口或使用80/8080端口。比如客户端目标地址应为：listservice-xxxxxx.a.run.app:443
• 本地环境可能用的是无端口或自定义端口，但Cloud Run对外仅在443端口提供加密gRPC服务，必须指定该端口
• 检查代码中gRPC客户端的地址配置，避免硬编码本地测试用的端口或地址

2. 强制启用gRPC TLS加密 #

• Cloud Run不支持明文gRPC连接，客户端必须配置TLS。如果你的@grpc/grpc-js客户端未启用TLS，会直接导致连接失败
• 正确配置示例：

  const grpc = require('@grpc/grpc-js');
  const ListServiceClient = require('./proto/listservice_grpc_pb').ListServiceClient;
  
  const client = new ListServiceClient('listservice-xxxxxx.a.run.app:443', {
    credentials: grpc.credentials.createSsl(),
  });
  

3. 验证容器端口绑定配置 #

• Cloud Run要求容器监听$PORT环境变量指定的端口（默认8080），对外的443端口会转发到这个容器端口
• 确认listservice的代码或启动命令，确实将gRPC服务绑定到了$PORT环境变量对应的端口，而非固定端口

4. 排查服务网络连通性 #

• 可在frontend容器内执行命令测试listservice的gRPC服务可达性：

  curl -v https://listservice-xxxxxx.a.run.app:443
  

  若返回HTTP/2 200及gRPC相关响应头，说明网络连通正常；若出现超时/连接拒绝，需检查网络策略或服务状态

5. 检查listservice健康检查状态 #

• Cloud Run的健康检查失败会导致服务无法接收流量。确认listservice的健康检查配置正确：
  • 如果用gRPC健康检查，需确保服务实现了grpc.health.v1.Health接口
  • 如果用HTTP健康检查，需确保指定的端点能返回200状态码

6. 分析listservice日志 #

• 不要仅关注frontend的错误日志，查看listservice的日志：
  • 若没有任何请求记录，说明frontend的调用地址/TLS配置有问题
  • 若有请求记录但返回错误，根据日志信息排查服务内部逻辑问题

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