yml2213
c3fd299f3a
生产是 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。
42 lines
1.1 KiB
Python
42 lines
1.1 KiB
Python
"""全局测试配置与 MySQL 测试环境初始化。
|
|
|
|
数据库连接串由根目录 ``conftest.py`` 在导入应用模块之前设好（见那里的说明），
|
|
因此这里可以正常按顺序导入，不需要靠 import 先后保证正确性。
|
|
"""
|
|
|
|
import pytest
|
|
|
|
import web.backend.models # noqa: F401 确保所有 ORM 模型注册到 Base.metadata
|
|
from tests.support.db import (
|
|
clear_tables,
|
|
get_test_engine,
|
|
init_test_schema,
|
|
make_test_session,
|
|
)
|
|
|
|
|
|
@pytest.fixture(scope="session", autouse=True)
|
|
def setup_test_database():
|
|
"""测试会话级别：在测试库中建立干净一致的全新数据库结构。"""
|
|
engine = get_test_engine()
|
|
init_test_schema(engine)
|
|
yield engine
|
|
|
|
|
|
@pytest.fixture(autouse=True)
|
|
def clean_tables_per_test():
|
|
"""用例级别：每个测试运行前后清空表数据，保证用例完全隔离且无残余状态。"""
|
|
clear_tables()
|
|
yield
|
|
clear_tables()
|
|
|
|
|
|
@pytest.fixture
|
|
def db():
|
|
"""提供一个带自动关闭的测试 Session fixture。"""
|
|
session = make_test_session()
|
|
try:
|
|
yield session
|
|
finally:
|
|
session.close()
|