在MariaDB上并行运行Django测试时提示'mysqldump不存在'

问题背景 #

本地运行的Django项目，数据库部署在Docker容器中的MariaDB 10.6。常规manage.py test能正常执行，但添加--parallel参数并行运行测试时，抛出错误：

FileNotFoundError: [Errno 2] No such file or directory: 'mysqldump'

相关配置信息：

docker-compose.yml #

services:
  db:
    container_name: my_db
    env_file: .env
    image: mariadb:10.6.17
    ports:
      - 5556:3306
    restart: unless-stopped
    volumes:
      - ./docker/db/init:/docker-entrypoint-initdb.d
      - mysql_data:/var/lib/mysql

volumes:
  mysql_data:

settings.py数据库配置 #

# Picks up DATABASE_URL='mysql://dbuser:dbpw@localhost:5556/myproject' :
DATABASES = {"default": dj_database_url.config()}
DATABASES["default"]["ENGINE"] = "django.db.backends.mysql"

原因分析 #

Django并行测试时，需要为每个测试进程克隆独立的测试数据库。对于MySQL/MariaDB后端，克隆操作依赖mysqldump工具生成数据库备份，再导入到新的测试库中。但本地环境未安装MariaDB/MySQL客户端工具，导致系统找不到mysqldump命令。

解决方案 #

方案1：本地安装MariaDB/MySQL客户端工具 #

只需安装客户端（无需安装数据库服务器）即可获取mysqldump工具：

• macOS：通过Homebrew安装

  # 安装MariaDB客户端
  brew install mariadb-client
  # 或安装MySQL客户端
  brew install mysql-client
  

  若安装后提示路径问题，将客户端路径添加到环境变量：echo 'export PATH="/usr/local/opt/mariadb-client/bin:$PATH"' >> ~/.zshrc（根据使用的shell调整）

• Linux（Ubuntu/Debian）：

  sudo apt update && sudo apt install mariadb-client
  

• Windows：下载MariaDB官方客户端包，解压后将包含mysqldump.exe的目录添加到系统环境变量PATH中。

方案2：指定mysqldump完整路径（可选） #

若不想在本地安装客户端，可尝试使用Docker容器内的mysqldump工具：

1. 先在容器内创建工具路径别名：

   docker exec -it my_db ln -s /usr/bin/mysqldump /usr/local/bin/mysqldump
   

2. 在Django数据库配置中指定mysqldump的调用命令：

   DATABASES["default"]["OPTIONS"] = {
       "mysqldump_path": "docker exec my_db mysqldump"
   }
   

   注意：此方式需要当前用户具备Docker命令执行权限，且性能可能不如本地工具。

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