test(db): 测试改用真实 MySQL,方言差异不再漏到生产
生产是 MySQL 8、测试是 SQLite,两者的方言差异在本地完全测不出来。今天为此 付出了两次代价: 1. `ORDER BY ck_checked_at ASC NULLS FIRST` 在 SQLite 上完全正常,本地 258 条 全绿,一部署到生产第一次巡检就 1064 语法错误(MySQL 不支持 NULLS FIRST); 2. P1b 自动重登的结算复用调度器事务读取,在 SQLite 下看不出问题,但在 MySQL 的 REPEATABLE READ 下读到的是批次开始前的快照 —— 10 条实际成功的重登全部被记成 失败。SQLite 的读一致性与 MySQL 不同,这类问题跑一万遍也复现不出来。 改动: - 新增 tests/support/db.py:测试专用引擎/会话工具,连接串从 .env 读取, 默认指向独立的 douyu_login_test 库; - 新增 tests/conftest.py:会话级建好表结构,每个用例前后清空所有表做隔离; - 根 conftest.py 接管连接串设置:它在 pytest 收集阶段最先执行,在这里把 DATABASE_URL 指向测试库,应用模块首次 import 拿到就是 MySQL,不依赖任何 import 顺序(原先这里是 sqlite:// 兜底,改造后会变成「先建 SQLite engine 再打补丁换成 MySQL」,顺序一变就静默跑错库); - 21 个测试文件的 setup 样板统一改用共享测试引擎; - 两个迁移测试改为在临时库 douyu_login_mig_<随机> 上跑完整 alembic upgrade head, 跑完 drop —— 迁移脚本本身也终于在 MySQL 上被验证; - dev.sh 与 README 的过时说明一并更新(原先写着「不需要 MySQL / .env 配置」; 「测试各自建 SQLite 内存库」)。 安全与易用: - 测试库名与开发库同名时**直接拒绝运行**(clear_tables 会 DELETE 所有表, 一旦 TEST_MYSQL_DATABASE 被指到 douyu_login 就是数据灾难); - 连不上 MySQL 时给出可操作提示(先 ./dev.sh 起库 / 用 TEST_MYSQL_DATABASE 覆盖), 而不是抛一段 SQLAlchemy 原始堆栈。 验收: - 全量 301 条通过,连跑两次结果一致(隔离有效),耗时约 12.5 秒(原 SQLite 约 3.6 秒); - 单文件独立运行通过(不依赖全量执行顺序); - `grep -rn sqlite tests/ conftest.py` 已无实际用法; - **方言确实生效**:临时把一条查询改回 `NULLS FIRST`,13 条测试立刻变红(含运行期 失败),还原即恢复;这条由 test_generated_sql_is_mysql_compatible 长期守着。 代价(已在 README 与规划附录 C.2 记明):跑测试前必须先有 MySQL,pre-push 钩子 同理;CI 需要 service container。
This commit is contained in:
@@ -26,7 +26,7 @@ live-hub-py/
|
||||
│ ├── frontend/ # React + Ant Design + Vite
|
||||
│ └── extension/ # 虎牙浏览器兑换助手
|
||||
├── services/yyb-worker/ # 应用宝协议运行时(随主镜像部署)
|
||||
├── tests/ # pytest(默认 SQLite 内存库)
|
||||
├── tests/ # pytest(跑在真实 MySQL 测试库上)
|
||||
├── docs/ # 协议与联调文档(结论以「虎牙 Cookie 路线状态」为准)
|
||||
├── deploy.sh / dev.sh # 生产部署 / 本机热更新
|
||||
└── docker-compose.yml # 应用容器 + MySQL 8.4
|
||||
@@ -111,7 +111,17 @@ uv run --group dev pytest tests/test_cookie_operations.py
|
||||
docker compose --profile test run --rm test
|
||||
```
|
||||
|
||||
测试各自建 SQLite 内存库;根目录 `conftest.py` 兜底 `DATABASE_URL` / `APP_ENCRYPTION_KEY`,防止误连开发/生产库。迁移链冒烟见 `tests/test_migrations.py`。兑换、下单、支付属于写操作,默认用 mock 做契约测试,不打真实支付。
|
||||
测试跑在**真实 MySQL** 上(不再使用 SQLite):生产是 MySQL,SQLite 与它有方言差异,
|
||||
曾出现「`ORDER BY ... NULLS FIRST` 本地全绿、生产直接 1064」的事故。因此:
|
||||
|
||||
- 先起数据库:`./dev.sh`(docker compose,MySQL 映射到 `127.0.0.1:3307`);
|
||||
- 测试库默认 `douyu_login_test`,可用 `TEST_MYSQL_DATABASE` 覆盖;**库名与开发库相同时
|
||||
会被 `tests/support/db.py` 拒绝运行**(每个用例前后会清空所有表,防误清);
|
||||
- `tests/conftest.py` 在导入应用模块前把连接串指向测试库,并把每用例的表清空交给 autouse fixture;
|
||||
- 迁移链冒烟见 `tests/test_migrations.py`:它在临时库 `douyu_login_mig_<随机>` 上跑完整
|
||||
`alembic upgrade head`,跑完 drop。
|
||||
|
||||
兑换、下单、支付属于写操作,默认用 mock 做契约测试,不打真实支付。
|
||||
|
||||
启用提交/推送门禁(改过前端会跑 TypeScript,与 Docker `npm run build` 的 `tsc -b` 一致):
|
||||
|
||||
@@ -127,7 +137,7 @@ docker compose --profile test run --rm test
|
||||
|
||||
## 技术栈
|
||||
|
||||
- 后端:FastAPI + SQLAlchemy + MySQL 8.4(测试用 SQLite)+ JWT
|
||||
- 后端:FastAPI + SQLAlchemy + MySQL 8.4(测试同样跑 MySQL)+ JWT
|
||||
- 前端:React + Ant Design + Vite
|
||||
- 核心:Python 3.12 + OpenCV + ONNX + pycryptodome + curl-cffi
|
||||
- 迁移:Alembic
|
||||
|
||||
Reference in New Issue
Block a user