You need to enable JavaScript to run this app. docker-compose部署时Go应用连接Elasticsearch报connection refused问题排查
优惠活动
大模型
产品
解决方案
定价
更多

docker-compose部署时Go应用连接Elasticsearch报connection refused问题排查

问题定位与修复方案

你的基础认知校验

  • 跨独立容器不能通过localhost互通、需要借助Docker自定义网络的服务名作为连接地址,这个判断完全正确。从你提供的网络inspect结果看,Go应用通过elastic:9200正常解析到172.28.0.3的地址链路没有问题,连接地址本身不需要调整。
  • 关于Elasticsearch默认仅绑定localhost、需要配置network.host=0.0.0.0对外提供访问的认知也符合官方规则,配置思路方向没有错,但你漏了ES 7.x版本的启动校验逻辑,这是本次连接失败的核心诱因。

连接拒绝的真正根因

从日志看wait-for-it连续15秒都没能建立到elastic:9200的TCP连接,说明Elasticsearch容器根本没有在9200端口正常对外监听,通常由两个原因叠加导致:

  1. ES启动触发生产校验直接终止进程
    ES 7.x版本只要检测到你配置的网络监听地址不是回环地址(比如你现在设置的0.0.0.0),就会自动进入生产环境启动校验。本地开发场景下最容易触发校验失败的是宿主机vm.max_map_count内核参数默认值仅65530,达不到ES要求的最低262144的标准,ES会在启动流程中直接抛出Bootstrap检查失败的错误,进程直接终止,根本不会打开9200端口。
  2. 15秒默认等待时长远低于ES实际启动需求
    就算解决了校验拦截的问题,ES 7.9.3单节点第一次冷启动的完整流程(初始化索引、加载安全插件、绑定端口)通常需要30~60秒。而wait-for-it默认的15秒超时窗口,哪怕没有进程崩溃的问题,也等不到ES完成端口绑定。超时后脚本会直接结束等待拉起Go应用,这时候ES还在启动流程中没开放端口,自然就报connection refused。
  3. wait-for-it的多目标传参没有给ES单独留等待窗口
    你现在的调用方式是把三个服务的地址一次性传给wait-for-it,这类支持多目标的脚本版本,默认的15秒超时是全局共享的,不会给启动慢的ES单独预留时间,进一步放大了等待不充分的问题。

具体修复步骤

  1. 先解决ES被启动校验拦截的问题,根据你的开发场景二选一:
    • 常规做法:在宿主机执行命令sudo sysctl -w vm.max_map_count=262144临时生效,再把这个参数持久化写入/etc/sysctl.conf保证重启后不失效。同时给ES服务的环境变量补充两项配置:ES_JAVA_OPTS=-Xms512m -Xmx512m、xpack.security.enabled=false,降低本地启动的资源占用。
    • 纯本地快速验证:不想修改宿主机参数的话,直接在ES的环境变量里加ES_JAVA_OPTS="-Des.enforce.bootstrap.checks=false"跳过启动校验,注意这个配置绝对不能用在生产环境。
  2. 调整wait-for-it的超时逻辑,给ES单独预留足够的启动等待时间,把web服务的启动命令改成串联调用的形式,避免全局短超时的问题:
    command:
      - "./wait-for-it.sh"
      - "mongo:27017"
      - "--"
      - "./wait-for-it.sh"
      - "redis:6379"
      - "--"
      - "./wait-for-it.sh"
      - "elastic:9200"
      - "--timeout=60"
      - "--"
      - "./server"
    
  3. 启动前可以先单独拉起elastic容器看日志验证:只要日志里出现publish_address {xxx:9200}和node started的字样,就说明9200端口已经正常对外监听了,这时候再启动web服务,就不会再出现连接拒绝的问题。

补充说明:你现在Go端写的http://elastic:9200连接配置完全正确,从Docker网络配置看,自定义网络内的服务名解析、容器IP互通都是正常的,不需要额外修改连接逻辑。

内容的提问来源于stack exchange,提问作者Hokdre

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 08:45:04