Docker Compose部署TestLink时数据库连接失败问题求助

针对你遇到的TestLink容器无法连接MariaDB的问题，逐一排查并给出解决方案：

1. 核心问题：MariaDB服务未完全就绪时TestLink已启动 #

depends_on仅能保证MariaDB容器启动，无法确保数据库服务完成初始化并处于可用状态。Bitnami镜像支持健康检查，可通过配置让TestLink等待MariaDB服务就绪。

修改docker-compose-testlink.yml中mariadb-testlink服务配置，添加健康检查：

mariadb-testlink:
  image: bitnami/mariadb:latest
  shm_size: 2g
  container_name: mariadb-testlink
  environment:
    - ALLOW_EMPTY_PASSWORD=yes
    - MARIADB_USER=bn_testlink
    - MARIADB_PASSWORD=bitnami
    - MARIADB_DATABASE=bitnami_testlink
  volumes:
    - mariadb-data_testlink:/bitnami/mariadb
  networks:
    - testlink_network
  # 添加健康检查配置
  healthcheck:
    test: ["CMD", "/opt/bitnami/scripts/mariadb/healthcheck.sh"]
    interval: 10s
    timeout: 5s
    retries: 5

同时修改testlink服务的depends_on，添加健康检查依赖：

testlink:
  shm_size: 1g
  image: bitnami/testlink:latest
  depends_on:
    mariadb-testlink:
      condition: service_healthy  # 等待MariaDB健康检查通过
  # 其余配置保持不变

2. 修正绑定卷路径错误 #

你配置的MariaDB绑定卷device路径缺少开头的/，会被识别为相对路径，导致MariaDB无法正确挂载目录、初始化失败。

调整volumes中的device路径为绝对路径：

volumes:
  testlink_data:
  testlink_code:
  mariadb-data_testlink:
    driver: local
    driver_opts:
      type: 'none'
      o: 'bind'
      device: '/home/$USER/Project/testlink/mariadb/'  # 开头添加/

3. 修复绑定目录权限问题 #

主机绑定目录的权限可能导致MariaDB容器无法读写数据，进而引发服务异常。执行以下命令调整目录权限：

# 确保目录存在
mkdir -p /home/$USER/Project/testlink/mariadb/
# 设置适配Bitnami容器的权限（容器使用uid/gid为1001的用户）
sudo chown -R 1001:1001 /home/$USER/Project/testlink/mariadb/

4. 手动验证网络与数据库连接 #

若以上步骤未解决问题，手动验证TestLink容器与MariaDB的连通性：

1. 进入TestLink容器：

   docker exec -it <testlink容器名称> /bin/bash
   

2. 安装mysql客户端（容器内无此工具时执行）：

   apt update && apt install -y mysql-client
   

3. 尝试连接MariaDB：

   mysql -u bn_testlink -pbitnami -h mariadb-testlink bitnami_testlink
   

   连接失败则说明网络或数据库配置存在问题；连接成功则需检查TestLink内部配置是否正确。

5. 通过日志定位具体问题 #

查看容器日志获取详细错误信息：

# 查看MariaDB日志
docker logs mariadb-testlink
# 查看TestLink日志
docker logs <testlink容器名称>

日志通常会包含数据库初始化失败、权限不足或连接超时的具体细节，帮助进一步定位问题。

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