Docker Compose部署遇mysql可执行文件未找到及服务重启问题

咱们先拆解下你遇到的问题：核心是mysql命令找不到导致容器执行失败，加上数据库连接异常引发关联服务持续重启。下面一步步来解决这些问题：

1. 定位mysql命令找不到的根源 #

错误提示exec: "mysql": executable file not found in $PATH，说明执行这个命令的容器里根本没装MySQL客户端工具。看你的docker-compose配置，worker、websocket_listener甚至bitpal服务用的都是python:3.5基础镜像，这个镜像默认不带mysql客户端，所以当你的install.sh或start_dev.sh脚本里调用mysql命令时，自然会触发这个错误。

解决方法：给需要执行mysql命令的容器补上客户端 #

你有两个可选方案：

方案A：修改自定义Dockerfile，添加MySQL客户端

你的项目已经有Dockerfile了，直接在里面加安装命令（python:3.5基于Debian，用apt-get安装）：

FROM python:3.5
RUN mkdir -p /bitpal
WORKDIR /bitpal
EXPOSE 80
# 安装MySQL客户端，安装后清理缓存减小镜像体积
RUN apt-get update && apt-get install -y --no-install-recommends mysql-client && rm -rf /var/lib/apt/lists/*
ADD requirement.txt /bitpal/
RUN python3.5 -m pip install -r /bitpal/requirement.txt

然后在docker-compose.yml里，把bitpal、worker、websocket_listener服务的image: python:3.5改成build: .（假设Dockerfile在项目根目录），这样启动时会自动构建包含mysql客户端的镜像：

bitpal:
  build: .
  restart: always
  # 其他配置保持不变...
worker:
  build: .
  restart: always
  # 其他配置保持不变...
websocket_listener:
  build: .
  restart: always
  # 其他配置保持不变...

方案B：替换脚本中的mysql命令（更轻量化，推荐）

如果你的脚本里用mysql只是为了初始化数据库或执行SQL，可以改用Django自带的工具，完全不需要依赖MySQL客户端：

• 执行SQL文件：用python manage.py dbshell < your_sql_file.sql
• 数据库迁移：直接用python manage.py migrate
  这样既避免了额外依赖，也更符合Django项目的最佳实践。

2. 修正MySQL容器配置，确保数据库正常初始化 #

你的docker-compose.yml里MySQL服务的环境变量有个小问题：mysql:5.7镜像的官方环境变量是MYSQL_DATABASE（不是你写的MYSQL_DB），用来自动创建初始数据库。另外，MYSQL_USER=root完全没必要，root用户默认就存在，你只需要设置MYSQL_ROOT_PASSWORD即可。修改后的mysql服务配置：

mysql:
  image: mysql:5.7
  restart: always
  hostname: mysql
  container_name: mysql
  environment:
    - MYSQL_ROOT_PASSWORD=password
    - MYSQL_DATABASE=bitpal  # 这里改成官方指定的MYSQL_DATABASE
  ports:
    - "3306:3306"
  # 如果需要初始化权限，把你的mysql-init.txt挂载到官方指定的初始化目录
  volumes:
    - ./mysql-init.txt:/docker-entrypoint-initdb.d/mysql-init.txt

这样MySQL容器启动时会自动创建bitpal数据库，并且自动执行/docker-entrypoint-initdb.d/下的初始化脚本，不需要在其他容器里手动执行权限命令。

3. 确保Django能正确连接到MySQL数据库 #

检查你的settings.py：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'bitpal',
        'USER': 'root',
        'PASSWORD': 'password',
        'HOST': SECRETS['db']['default']['hostname'],  # 务必确保这个值是'mysql'
        'PORT': '3306',
        'OPTIONS': {'autocommit': SECRETS['db']['default']['commit']}
    }
}

要保证SECRETS['db']['default']['hostname']的值是mysql（docker-compose里MySQL服务的名称），因为容器间是通过服务名通信的。如果这个值不对，Django就连接不上数据库，直接导致服务持续重启。

4. 处理服务启动顺序问题（可选但关键） #

depends_on只保证容器启动的先后顺序，不保证MySQL服务已经完全就绪（比如MySQL启动需要几秒初始化）。所以你的bitpal、worker服务可能在MySQL还没准备好时就尝试连接，导致失败重启。可以在启动脚本里加一个等待逻辑：
比如在start_dev.sh开头添加：

# 等待MySQL就绪（如果用了方案A安装了mysql客户端）
until mysql -h mysql -u root -ppassword -e "SELECT 1"; do
  echo "Waiting for MySQL to be ready..."
  sleep 2
done

如果用了方案B，也可以用nc命令检查端口（需要先在容器里装nc：apt-get install -y netcat）：

until nc -z mysql 3306; do
  echo "Waiting for MySQL port..."
  sleep 2
done

最后验证步骤 #

1. 停止并清理现有容器：docker-compose down
2. 构建新镜像（如果用了方案A）：docker-compose build
3. 启动服务：docker-compose up -d
4. 实时查看日志：docker-compose logs -f，检查是否还有错误提示。

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