Dockerfile可正常构建运行，Docker Compose报RPC错误求助

错误来源解析 #

该错误属于gRPC通信层异常：docker-compose在尝试与容器内的gRPC服务建立连接时，发起了HTTP/2明文（h2c）协议升级请求，但服务端返回404响应。本质是请求的目标地址、端口或服务监听配置不匹配，导致服务端无法识别对应的gRPC服务端点。

待排查的可能问题 #

• docker-compose端口映射与启动命令不匹配
  • 核对docker-compose.yml的端口映射是否和docker run时完全一致，重点确认gRPC服务的监听端口（默认50051，可能自定义）。比如docker run用了-p 50051:50051，但docker-compose里写成- "50050:50051"，会导致请求发到错误端口触发404。
  • 检查docker-compose中服务的command/entrypoint是否覆盖了docker run时的启动参数，比如误修改了gRPC服务的监听端口配置。
• 容器内gRPC服务监听地址错误
  • 确认服务是否监听0.0.0.0而非127.0.0.1。若服务仅监听本地回环地址，docker-compose的端口映射无法穿透到容器内部，外部请求会被拒绝。
• docker-compose网络配置异常
  • 若使用自定义网络，检查服务间通信是否使用了正确的服务名/容器名。比如docker-compose中服务名为grpc-server，但客户端配置的是localhost，在自定义网络内localhost指向客户端容器自身，而非目标服务容器。
  • 排查是否开启了严格的网络隔离策略，导致docker-compose无法正常访问容器内的gRPC端口。
• gRPC服务端点配置错误
  • 部分gRPC服务会配置特定路径前缀（如/grpc），若docker-compose或客户端请求根路径/，会因无法匹配端点返回404。需确认服务的gRPC端点路径是否正确。
  • 检查服务是否同时兼容HTTP/1和gRPC协议，是否存在路由配置错误，将gRPC请求转发到了HTTP/1的处理逻辑，导致无法完成h2c协议升级。
• docker-compose版本兼容性问题
  • 部分旧版本docker-compose对gRPC的h2c协议支持存在缺陷，尝试升级到最新稳定版后重新测试。

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