Django+Elasticsearch容器化后连接失败：索引重建报错求助

问题描述 #

非容器化环境下Django与Elasticsearch运行正常，容器化后执行以下命令：

docker exec -it 4b93cbdacf84 python manage.py search_index --rebuild

返回连接拒绝错误：

elasticsearch.exceptions.ConnectionError: ConnectionError(<urllib3.connection.HTTPConnection object at 0x7f9b532c8940>: Failed to establish a new connection: [Errno 111] Connection refused) caused by: NewConnectionError(<urllib3.connection.HTTPConnection object at 0x7f9b532c8940>: Failed to establish a new connection: [Errno 111] Connection refused)

Elasticsearch容器可通过宿主机localhost:9200正常访问，但Django容器无法和ES容器建立连接。

解决方案 #

1. 修正ES地址配置 #

容器环境中，localhost指向容器自身而非宿主机，必须使用docker-compose中ES服务的名称作为访问主机名。

方式一：直接修改settings.py

ELASTICSEARCH_DSL = {
    'default': {
        'hosts': 'es:9200'  # 使用docker-compose里ES服务的名称"es"作为主机地址
    },
}

方式二：通过环境变量配置（更灵活）

在docker-compose.yaml的web服务中添加环境变量：

web:
  # ...其他原有配置
  environment:
    # ...原有环境变量
    - ELASTICSEARCH_DSL_HOSTS=es:9200

此方式无需修改settings.py，依赖原配置中的os.getenv逻辑即可自动获取正确地址。

2. 确认容器在同一网络 #

检查docker-compose.yaml，确保web和es服务加入了同一个网络（当前配置中两者都在elastic网桥网络下，此部分无需修改）。

3. 等待Elasticsearch完全就绪 #

depends_on仅保证容器启动顺序，不确保ES服务完全启动完成。可以在web服务启动时添加等待逻辑：

web:
  command: >
    sh -c "
      until curl -s http://es:9200 > /dev/null; do
        sleep 5;
      done;
      python manage.py runserver 0.0.0.0:8000
    "

4. 验证连接有效性 #

重启容器后，进入Django容器执行测试命令：

docker exec -it <web-container-id> curl http://es:9200

若返回Elasticsearch状态信息，说明连接正常，此时再执行索引重建命令即可成功。

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