Docker Compose部署Python应用连接Crate-DB容器失败求助

核心问题分析 #

Crate-DB默认将HTTP服务和PostgreSQL兼容服务绑定到容器内部的localhost，仅允许容器自身访问，导致同网络下的其他容器（如Python服务、Grafana）无法连接。此外，depends_on仅控制容器启动顺序，不保证Crate-DB服务完全就绪，也可能引发连接超时。

具体修复步骤 #

1. 修改Crate-DB的启动配置

更新docker-compose.yml中crate-db服务的command字段，添加绑定所有网卡的配置：

command: crate -Cauth.host_based.enabled=false -Ccluster.name=democluster -Chttp.cors.enabled=true -Chttp.cors.allow-origin="*" -Chttp.host=0.0.0.0 -Cpsql.host=0.0.0.0

• -Chttp.host=0.0.0.0：让Crate的HTTP服务监听所有网卡，允许其他容器通过服务名访问
• -Cpsql.host=0.0.0.0：开启PostgreSQL兼容服务的外部访问，解决Grafana的连接问题

2. 修正Python脚本的连接地址

将Python代码中的连接地址改为Docker Compose服务名crate-db：

from crate import client
connection_device = client.connect("http://crate-db:4200/")

在Docker Compose默认网络中，服务名会被自动解析为对应容器的IP，无需手动指定IP。

3. 添加Crate-DB健康检查（可选但推荐）

避免Python服务在Crate-DB未就绪时启动，添加健康检查配置到crate-db服务：

crate-db:
  # 其他配置...
  healthcheck:
    test: ["CMD-SHELL", "curl -f http://localhost:4200/_cluster/health || exit 1"]
    interval: 10s
    timeout: 5s
    retries: 5

同时修改py-service的depends_on，依赖Crate-DB的健康状态：

py-service:
  # 其他配置...
  depends_on:
    crate-db:
      condition: service_healthy

4. Grafana连接配置修正

确保Grafana的Crate-DB数据源配置为：

• 主机：crate-db:5432
• 数据库：doc（Crate默认数据库）
• 用户名：crate（默认用户名，无需密码，因为已禁用host-based认证）

验证修复 #

执行以下命令重启服务：

docker-compose down
docker-compose up -d

查看Python服务日志确认连接成功，同时检查Grafana数据源是否能正常连接。

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