Docker Compose部署ArangoDB时初始化脚本连接失败问题排查

1. 核心问题定位：连接地址错误 #

不管脚本在容器内还是外部执行，用127.0.0.1都是常见误区：

• 容器外部执行：127.0.0.1指向你的本地主机，若未正确配置端口映射，或脚本未接入Docker容器网络，自然无法访问ArangoDB容器内的服务；
• 容器内部执行：虽理论上127.0.0.1指向容器自身，但如果脚本硬编码了错误的端口、或ArangoDB未绑定0.0.0.0（默认是绑定的，但需确认），也会导致连接失败。

修正方案：

• 外部执行脚本：若已配置端口映射（如8529:8529），可使用localhost:8529；若想通过Docker内部网络访问，直接用Compose中ArangoDB的服务名（比如服务叫arangodb）作为地址，即arangodb:8529；
• 容器内部执行脚本：确保连接地址是127.0.0.1:8529，同时验证ArangoDB的启动参数--server.endpoint为tcp://0.0.0.0:8529（默认配置）。

示例初始化命令：

# 外部执行（同Docker网络内）
arangosh --server.endpoint tcp://arangodb:8529 --server.username root --server.password yourpwd

# 容器内执行
arangosh --server.endpoint tcp://127.0.0.1:8529 --server.username root --server.password yourpwd

2. 确保脚本在ArangoDB完全就绪后执行 #

Docker的depends_on仅保证容器启动顺序，不代表服务已就绪。需在脚本中添加等待逻辑，直到ArangoDB服务可用：

# 循环检查ArangoDB健康状态
until curl --fail http://arangodb:8529/_api/version; do
  echo "等待ArangoDB就绪..."
  sleep 2
done

# 执行数据库初始化操作
arangosh --server.endpoint tcp://arangodb:8529 --server.username root --server.password yourpwd \
  --execute "db._createDatabase('testdb'); db._useDatabase('testdb'); db._createCollection('testcol');"

3. 优化Docker Compose配置 #

给ArangoDB添加健康检查，确保依赖它的服务（或初始化脚本）仅在数据库完全就绪后启动：

version: '3.8'
services:
  arangodb:
    image: arangodb:latest
    environment:
      ARANGO_ROOT_PASSWORD: yourpwd
    ports:
      - "8529:8529"
    volumes:
      - arangodb_data:/var/lib/arangodb3
    healthcheck:
      test: ["CMD", "curl", "--fail", "http://localhost:8529/_api/version"]
      interval: 5s
      timeout: 3s
      retries: 5

  go-api:
    build: ./api
    depends_on:
      arangodb:
        condition: service_healthy
    environment:
      ARANGODB_ADDR: http://arangodb:8529
      ARANGODB_USER: root
      ARANGODB_PWD: yourpwd
volumes:
  arangodb_data:

4. 容器内脚本的额外排查点 #

若在ArangoDB容器内执行脚本仍失败：

• 执行netstat -tulpn验证ArangoDB是否在监听0.0.0.0:8529；
• 确认脚本内的用户名、密码与容器启动时ARANGO_ROOT_PASSWORD环境变量一致；
• 检查脚本是否存在拼写错误（如端口写成8259）。

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