Envoy代理报upstream connect error 503服务不可用如何解决

该503错误的核心原因是Envoy配置中的上游服务地址错误：

Envoy与gRPC服务端运行在独立容器中，你配置的上游地址localhost:3000指向的是Envoy自身容器的本地网络，无法访问到gRPC服务端所在容器的3000端口。你的Go客户端能正常连通，说明gRPC服务端本身运行正常、网络策略无限制，问题完全出在Envoy的路由配置侧。

• 测试Envoy到gRPC服务端的网络连通性
  进入Envoy容器内部，执行nc -zv <gRPC服务端容器名/服务名> 3000验证连通性，确认地址、端口可访问。同一Docker网络或Kubernetes集群内，可以直接用服务名/容器名作为访问地址。
• 校验Envoy配置项合理性
  1. 保留http2_protocol_options: {}配置：gRPC基于HTTP/2协议，该配置是必须的，不需要移除
  2. 调整集群类型：如果上游地址是固定的服务名/IP，可将集群type从logical_dns改为strict_dns或STATIC，降低DNS解析异常概率
  3. 确认TLS配置匹配：如果gRPC服务端未开启TLS，需要在Envoy集群配置中显式关闭TLS，避免TLS握手失败
• 查看Envoy debug日志定位细节
  通过Envoy admin接口开启debug日志，获取更详细的错误信息：

curl -X POST http://localhost:9901/logging?level=debug

触发请求后查看Envoy日志，可明确是DNS解析失败、连接拒绝还是协议握手失败。

修改envoy.yaml中position_service集群的端点配置，将localhost替换为gRPC服务端的可访问地址，同时修正不规范的配置项：

clusters:
  - name: position_service
    connect_timeout: 2s
    type: strict_dns
    http2_protocol_options: {}
    lb_policy: round_robin
    load_assignment:
      cluster_name: position_service # 与集群名保持一致，原配置为cluster_0属于冗余错误
      endpoints:
        - lb_endpoints:
            - endpoint:
                address:
                  socket_address:
                    address: 替换为你的gRPC服务端容器名/服务名 # 如Docker Compose中的服务名grpc-server
                    port_value: 3000

修改配置后重启Envoy即可生效。

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