最轻量可控的MySQL沙箱是用Docker每次启动全新容器:--rm自动清理、-e设密码、-p映射端口、--name防重名、/dev/null占位数据目录;或离线用mysqld --initialize-insecure配干净datadir。

用 Docker 快速起一个干净、可销毁的 MySQL 实例
最轻量、最可控的沙箱方式就是每次测试都启动一个全新容器。它天然隔离数据、端口、配置,且启动/销毁都在秒级。
关键点在于:不挂载外部卷、不复用容器名、显式指定版本避免隐式拉取 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。
mysqld --initialize-insecure 启动无密码本地实例
适合离线、无 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)修复。
MySQL 8.0+ 的 CREATE DATABASE ... WITH OPTIONS 隔离元数据
单实例下想让多个测试互不干扰?靠数据库名前缀或独立 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 或定期重建实例。
Python pytest + pytest-mysql 插件实现测试函数级隔离
单元测试里每个 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 里残留旧密码——这些才是导致下次测试莫名其妙失败的根源。










