如何搭建mysql沙箱环境_mysql测试隔离方案

最轻量可控的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 里残留旧密码——这些才是导致下次测试莫名其妙失败的根源。