为什么自定义Dockerfile服务无法通过docker-compose网络连接InfluxDB？

问题根因 #

你遇到的连接拒绝问题本质是服务启动时序不匹配：

• docker-compose 原生的depends_on仅保证依赖容器的状态为running，不会等待容器内的应用完全初始化、端口就绪
• InfluxDB 2.x首次启动时需要执行初始化配置流程，端口对外暴露的时间晚于容器启动时间
• 你的Python脚本启动后会立即尝试建立连接，没有重试逻辑，一旦首次连接失败就直接抛出异常退出；而Grafana内置了连接重试机制，所以可以等InfluxDB就绪后成功连接

解决方案 #

以下三种方案任选其一即可：

方案1：给Python脚本增加连接重试逻辑（推荐，侵入性最低） #

修改main.py，在初始化InfluxDB客户端前增加重试和健康检查逻辑：

import os
from influxdb_client import InfluxDBClient, Point, WritePrecision
from influxdb_client.client.write_api import SYNCHRONOUS
from datetime import datetime
import random
import time

token = os.environ["KTS_TELEMETRY_INFLUXDB_TOKEN"]
org = os.environ["KTS_TELEMETRY_INFLUXDB_ORG"]
bucket = os.environ["KTS_TELEMETRY_INFLUXDB_BUCKET"]
url = os.environ["KTS_TELEMETRY_INFLUXDB_URL"]

# 新增连接重试逻辑
max_retry = 10
retry_interval = 2
client = None
for i in range(max_retry):
    try:
        client = InfluxDBClient(url=url, token=token)
        # 调用官方健康检查接口确认服务可用
        if client.health().status == "pass":
            print("InfluxDB连接成功")
            break
    except Exception as e:
        print(f"连接失败，第{i+1}次重试，错误信息：{str(e)}")
        time.sleep(retry_interval)
else:
    raise Exception("多次重试后仍无法连接InfluxDB，服务启动失败")

dbh = client.write_api(write_options=SYNCHRONOUS)

while True:
    symbol_name = 'rand_num'
    value = random.random()
    timestamp = datetime.utcnow()
    print(timestamp, symbol_name, value)
    point = Point("mem") \
        .field(symbol_name, value) \
        .time(timestamp, WritePrecision.NS)
    dbh.write(bucket, org, point)
    time.sleep(1)

方案2：通过健康检查控制容器启动依赖 #

修改docker-compose.yaml，给InfluxDB增加健康检查配置，让ads_agent等待InfluxDB完全就绪后再启动：

1. 给influxdb服务新增健康检查配置：

influxdb:
  # 原有配置保持不变
  healthcheck:
    test: ["CMD", "curl", "-f", "http://localhost:8086/health"]
    interval: 3s
    timeout: 2s
    retries: 10

2. 修改ads_agent的depends_on配置：

ads_agent:
  # 原有配置保持不变
  depends_on:
    influxdb:
      condition: service_healthy

方案3：在容器启动前等待端口就绪 #

修改ads_agent/Dockerfile，安装端口检测工具，启动脚本前先等待InfluxDB的8086端口可用：

FROM python:3.9
# 安装wait-for-it工具
RUN apt-get update && apt-get install -y wait-for-it && rm -rf /var/lib/apt/lists/*
COPY requirements.txt .
RUN pip install --upgrade pip
RUN pip install -r requirements.txt
COPY main.py .
# 先等待influxdb:8086端口通了再启动Python脚本
ENTRYPOINT ["wait-for-it", "influxdb:8086", "--", "/usr/local/bin/python3", "/main.py"]

验证方法 #

如果修改后仍有问题，可以临时将ads_agent的启动命令改为sleep 3600，启动后进入容器执行curl http://influxdb:8086/health，如果返回正常状态说明网络配置无问题，仍为启动时序导致的异常。

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