最轻量可控的MySQL沙箱是用Docker每次启动全新容器:--rm自动清理、-e设密码、-p映射端口、--name防重名、/dev/null占位数据目录;或离线用mysqld --initialize-insecure配干净datadir。
最轻量、最可控的沙箱方式就是每次测试都启动一个全新容器。它天然隔离数据、端口、配置,且启动/销毁都在秒级。
关键点在于:不挂载外部卷、不复用容器名、显式指定版本避免隐式拉取 latest(可能行为突变)。
docker run 时加 --rm,容器退出即自动清理-e MYSQL_ROOT_PASSWORD=123456 设定密码,避免初始化卡住-p 3307:3306 避免和本机 MySQL 冲突--name mysql-sandbox-$(date +%s) 防重名,方便排查docker run --rm -d \ --name mysql-sandbox-$(date +%s) \ -e MYSQL_ROOT_PASSWORD=123456 \ -p 3307:3306 \ -v /dev/null:/var/lib/mysql \ mysql:8.0.33
注意:/dev/null 挂载只是占位,确保容器内数据目录为空;真正需要保留 schema 可换用临时命名卷(docker volume create tmpvol && -v tmpvol:/var/lib/mysql),但测试完需手动 docker volume rm tmpvol。
适合离线、无 Docker 环境(如 CI 机器或旧版 macOS),但必须确保端口未被占用、且不暴露到公网。
这个模式跳过密码生成流程,直接生成空 root 密码,省去解析 error log 提取临时密码的步骤,更适配自动化脚本。
--datadir 指向干净空目录,否则启动失败--port=3307 和 --socket=/tmp/mysql-sandbox.sock 显式隔离通信面mysql -u root -S /tmp/mysql-sandbox.sock -e "ALTER USER 'root'@'localhost' IDENTIFIED BY 'test';"
常见错误:mysqld: Can't create/write to file '/path/to/data/aria_log_control' —— 说明 datadir 权限不对或父目录不存在,用 chown -R _mysql:_mysql $DATADIR(macOS)或 chown -R mysql:mysql $DATADIR(Linux)修复。
单实例下想让多个测试互不干扰?靠数据库名前缀或独立 DB 不够——DDL 可能跨库,用户权限也可能泄漏。MySQL 8.0.14 起支持 CREATE DATABASE 带 CHARACTER SET 和 COLLATE,但真正有用的是配合 mysql_native_password 插件限定认证方式,再用 CREATE USER 绑定 host 为 127.0.0.1(而非 %)限制连接来源。
CREATE USER 'testapp'@'127.0.0.1' IDENTIFIED WITH mysql_native_password BY 'pwd';,避免 caching_sha2_password 在某些客户端上握手失败GRANT ALL ON `testapp_%`.* TO 'testapp'@'127.0.0.1';,用通配符 DB 名防硬编码污染性能影响极小,但若测试中频繁创建/删除 DB,要注意 innodb_file_per_table=ON(默认)下每个 DB 对应一个表空间,碎片不自动回收,长期运行需 OPTIMIZE TABLE 或定期重建实例。
单元测试里每个 def test_* 都该操作一张干净表?靠人工 DROP TABLE IF EXISTS 易遗漏、易冲突。用 pytest-mysql 可自动管理生命周期。
它本质是封装了 Docker 启动逻辑,但比裸写 docker run 更可靠:会等待 MySQL ready,注入初始化 SQL,并在 fixture scope 结束时停掉容器。
pip install pytest-mysql
conftest.py 中声明 fixture,指定 version="8.0.33" 和 init_command="CREATE DATABASE testdb CHARACTER SET utf8mb4;"
mysql,即可拿到已连上的 mysql.connection 对象容易踩的坑:mysql fixture 默认 scope 是 session,意味着所有测试共用一个实例 —— 若需函数级隔离,得显式写 @pytest.fixture(scope="function") 并自己调 mysql.reset()(清空 DB)或改用 pytest-asyncio 配合临时库名。
沙箱不是“跑起来就行”,关键是销毁是否彻底。Docker 容器删了但卷没清、mysqld 进程僵死、~/.my.cnf 里残留旧密码——这些才是导致下次测试莫名其妙失败的根源。