如何在Docker容器内通过Python subprocess执行MySQL命令

嘿，这事儿其实挺好解决的！核心思路就是用subprocess在你的Python容器里执行Docker命令，直接调用MySQL容器内置的mysql客户端工具来跑SQL操作。我给你一步步拆解具体怎么弄：

1. 先确认你的Docker Compose服务名称 #

首先得搞清楚你在docker-compose.yml里给MySQL服务起的名字，比如大多数人会叫它db或者mysql。举个例子，你的Compose配置大概是这样：

services:
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_secure_password
      MYSQL_DATABASE: test_db
    # 其他配置比如端口映射、卷挂载...
  app:
    build: .
    depends_on:
      - db
    # 其他配置...

这里MySQL的服务名就是db，后面要用到它。

2. 给Python容器加Docker操作权限（关键步骤！） #

要让Python容器里能执行docker命令，你得把宿主机的Docker socket挂载到容器里，这样容器里的docker命令才能和宿主机的Docker守护进程通信。修改你的docker-compose.yml里的app服务部分：

app:
  build: .
  depends_on:
    - db
  volumes:
    # 挂载Docker socket，让容器能调用宿主机的Docker
    - /var/run/docker.sock:/var/run/docker.sock
    # 可选：如果你的Python基础镜像里没有docker命令，把宿主机的docker二进制文件挂载进去
    - /usr/bin/docker:/usr/bin/docker
  environment:
    # 把MySQL的配置用环境变量存起来，别硬编码在代码里！
    MYSQL_ROOT_PASSWORD: your_secure_password
    MYSQL_DATABASE: test_db
    MYSQL_SERVICE_NAME: db

3. 用subprocess执行MySQL命令的代码示例 #

现在你可以在Python脚本里用subprocess调用docker exec命令，进入MySQL容器执行mysql客户端指令了。比如下面这个执行查询的例子：

import os
import subprocess

def run_mysql_command():
    # 从环境变量里读取配置，安全又灵活
    mysql_password = os.getenv("MYSQL_ROOT_PASSWORD")
    mysql_db = os.getenv("MYSQL_DATABASE")
    mysql_service = os.getenv("MYSQL_SERVICE_NAME")

    # 构造要执行的docker命令
    cmd = [
        "docker", "exec", "-i", mysql_service,
        "mysql", "-uroot", f"-p{mysql_password}",
        mysql_db,
        "-e", "SELECT id, username FROM users;"  # 这里替换成你要执行的SQL
    ]

    try:
        # 执行命令并捕获输出
        result = subprocess.run(
            cmd,
            capture_output=True,
            text=True,
            check=True
        )
        print("✅ 命令执行成功，输出结果：")
        print(result.stdout)
    except subprocess.CalledProcessError as e:
        print(f"❌ 命令执行失败，错误信息：{e.stderr}")

if __name__ == "__main__":
    run_mysql_command()

4. 更稳妥的替代方案：用docker-compose exec #

如果你不想记容器的具体名字，用docker-compose exec会更省心——直接用服务名就行，不用管Compose生成的容器后缀（比如yourproject_db_1）。只需要把上面的cmd改成：

cmd = [
    "docker-compose", "exec", "-T", mysql_service,
    "mysql", "-uroot", f"-p{mysql_password}",
    mysql_db,
    "-e", "SELECT id, username FROM users;"
]

这里的-T参数是禁用伪终端，适合非交互式的脚本执行场景，避免一些奇怪的输出问题。

5. 一些注意事项 #

• 权限问题：挂载Docker socket后，容器里的用户需要有访问socket的权限。如果遇到权限错误，可以在Dockerfile里把容器用户加入docker组，或者临时用root用户运行（不推荐长期用root）。
• 避免硬编码敏感信息：永远别把密码直接写在代码里，用环境变量或者Docker secrets更安全。
• 容器里的docker命令：如果你的Python基础镜像（比如python:slim）里没有docker命令，除了挂载宿主机的docker，也可以在Dockerfile里安装docker-cli：

  FROM python:3.10-slim
  RUN apt-get update && apt-get install -y --no-install-recommends docker.io
  # 安装你的Python依赖，比如mysql-connector-python
  RUN pip install mysql-connector-python
  

其实话说回来，既然你已经能用mysql-connector的MySQLConnection正常操作数据库，除非是有必须用mysql客户端工具的特殊场景（比如执行复杂的shell脚本、导入大SQL文件），否则用连接器会更优雅哦！

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