GCP Cloud Run中Spring Boot微服务与Netflix Eureka通信故障排查

核心问题根源 #

Cloud Run的服务仅支持通过外部HTTPS域名（如https://helloworld-xyzxyzxyz-ew.a.run.app）访问，容器内部的私有IP/localhost无法被其他Cloud Run服务寻址。你的配置中prefer-ip-address: true会让微服务注册容器内部IP，导致服务间调用时出现连接拒绝；同时容器内部主机名无法被解析，触发Cannot determine local hostname日志。

解决方案步骤 #

1. 修改业务微服务Eureka配置 #

关闭IP优先策略，强制注册Cloud Run外部域名，并指定HTTPS端口：

eureka:
  instance:
    prefer-ip-address: false  # 禁用IP优先，改用域名
    hostname: ${CLOUD_RUN_SERVICE_DOMAIN}  # 环境变量传入服务的外部HTTPS域名
    secure-port-enabled: true  # 启用HTTPS端口
    non-secure-port-enabled: false  # 禁用HTTP端口
    secure-port: 443  # Cloud Run对外HTTPS端口
    status-page-url-path: /actuator/info  # 绑定Actuator状态页
    health-check-url-path: /actuator/health  # 绑定Actuator健康检查
  client:
    service-url:
      defaultZone: ${EUREKA_URL}
    fetch-registry: true
    register-with-eureka: true

# 启用Actuator端点（需添加spring-boot-starter-actuator依赖）
management:
  endpoints:
    web:
      exposure:
        include: health,info

2. 修改API Gateway Eureka配置 #

同样调整Gateway的注册信息，确保它能正确解析业务服务的域名：

eureka:
  instance:
    prefer-ip-address: false
    hostname: ${CLOUD_RUN_GATEWAY_DOMAIN}  # Gateway的外部HTTPS域名
    secure-port-enabled: true
    non-secure-port-enabled: false
    secure-port: 443
  client:
    service-url:
      defaultZone: ${EUREKA_URL}
    fetch-registry: true
    register-with-eureka: true

# 配置Gateway路由使用服务名，并启用HTTPS调用
spring:
  cloud:
    gateway:
      httpclient:
        ssl:
          useInsecureTrustManager: false  # 生产环境建议配置GCA信任存储
      routes:
        - id: business-service-route
          uri: lb://YOUR-BUSINESS-SERVICE-NAME  # 用Eureka注册的服务名，自动解析为HTTPS地址
          predicates:
            - Path=/api/**

3. 部署时配置环境变量 #

在Cloud Run控制台部署每个服务时，添加以下环境变量：

• CLOUD_RUN_SERVICE_DOMAIN：当前服务的外部访问域名（如https://your-service-xxxx-ew.a.run.app）
• EUREKA_URL：Eureka服务端的HTTPS地址（如https://eureka-server-xxxx-ew.a.run.app/eureka/）

4. Eureka服务端适配（若部署在Cloud Run） #

如果Eureka服务也部署在Cloud Run，需补充配置：

eureka:
  instance:
    hostname: ${CLOUD_RUN_EUREKA_DOMAIN}
    secure-port-enabled: true
    non-secure-port-enabled: false
    secure-port: 443

关键说明 #

• Cloud Run不支持容器间直接IP访问，必须通过外部域名+HTTPS 443端口通信
• 显式设置hostname可解决Cannot determine local hostname问题，避免InetUtils尝试解析容器内部无效主机名
• 启用Actuator是Eureka健康检查的必要条件，确保服务注册状态正常

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