This repository has been archived on 2026-10-02. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
NeteaseUrl/tests/test_deps.py
T
snowy-yang 96af56cc27 refactor: auth_system 全面异步化(aiosqlite),拆掉 web/services 层的 to_thread 桥接
拆掉两类垫片的最后一处:auth_system 原为同步 sqlite3 栈,web 层与 services 的
worker 只能靠 asyncio.to_thread 逐个桥接才不阻塞事件循环——每次 DB 访问都白付一次
线程池调度,且「同步调异步」的边界散落在 100+ 个调用点。B1 已把 worker 变成协程,
本批把访问层本身也迁到原生异步,两条线在此合拢。

改动(按子系统):
- auth_system:db.py 照 core/db.py 现有范式重建为原生异步访问层(aiosqlite + WAL)
  ——读路径 _q 每次独立连接、无锁、可并发;写路径 _x / write_transaction 用
  asyncio.Lock 串行化,写者不阻塞读者。users / cards / credits / ledger / logs /
  settings / mail / geo / backup 九模块随之全部 async/await;security.py 是纯计算
  (pbkdf2/normalize)不动。__init__ 去掉 _DB_LOCK 与 get_conn 导出。
- web:app / deps / billing / tasks_registry 与 routers/{admin_site,auth,music,
  register,user} 直接 await,拆掉包裹的 to_thread。deps.secret_key 改 async,
  连带 _parse_cookie 也 async(会话解析要读密钥)。
- services:_taskcore / tasks / downloads / podcast 的账本调用与查询直接 await。
  4 处 start_task 调用点(download.py)确认已 await。

设计取舍(为什么这么做,而不是直接包一层):
- 锁按**事件循环**隔离(_LOOP_LOCKS 以 id(loop) 为键):asyncio.Lock 绑定创建它的
  loop,应用主 loop 与测试各自的 loop 并存,跨 loop 复用会抛 "bound to a different
  event loop"。
- WAL 切换用**独立锁** _wal_lock 而非 _write_lock:execute() 已持写锁,再在锁内
  connect→_configure 会自锁死(asyncio.Lock 非重入)。切换 + 标记在专用锁内串行并
  二次复查,否则并发首连会同时执行 PRAGMA journal_mode=WAL 争排他锁报
  database is locked(core/db.py 同款教训,实测复现)。
- force_wal 保留:journal_mode 持久化在库文件头,库文件被删重建时新文件不继承,
  必须重设。exists() 判定须在 aiosqlite.connect **之前**(connect 会创建空文件)。
- connect() 用 DB_PATH.parent 兜底建目录,优于 DATA_DIR:生产两者相同,但测试
  monkeypatch 只换 DB_PATH 时兜底仍能命中正确目录。

留在 to_thread 上的仅剩**正当的阻塞卸载**,不是同步门面:PBKDF2 的 10 万次迭代
(登录链路每次都要跑)、smtplib 发信、备份文件的 copy2 / os.replace、secret.key
的文件 IO。原有 aria2 / downloader / zip 侧的 to_thread 未动。

不变量逐条保持(迁移只改执行模型,不改语义):
- ledger_settle 幂等:账本非 open 直接 return 0,重启后重放不重复退款;
- 终态先到先得:_mark_task_terminal 对已 done/error/canceled 的任务直接 return,
  堵住 canceled→error 的非法迁移边;
- settle 必须在任务锁**外**调用(ledger_settle 要抢 SQLite 写锁,busy 最长 15s,
  持任务锁会让全站进度/提交/取消随库停摆);
- reserve_and_open 的预扣与开账同事务,消除原两步之间的崩溃丢账窗口。

路径真源红线:DATA_DIR / DB_PATH / BACKUP_DIR / SECRET_KEY_PATH 仍是 auth_system.db
的**模块全局**(用与 core.db 相同的表达式,但**不是**它的别名)。测试只 patch
auth_system.db.*,若改成 core.db 的别名会静默把测试写到生产库。已核 data/site.db
读写前后 sha256 完全一致。
顺带清掉 get_conn:迁移后它只剩「转调 connect()」一层空壳、全仓零消费者(测试
直接开裸连接、备份用 db.connect()),保留等于留一条「拿裸连接自己写」的口子。

测试:19 个文件同步迁移——10 个文件的 web.deps.secret_key 替身改 async;
test_db_conn.py 的多线程首连用例按异步语义拆成 2 条(单 loop gather(16) 覆盖批量
并发首连、WAL 就绪后 8 线程各自 loop 建连覆盖跨 loop);test_billing_scope.py 去掉
多余的 @pytest.mark.anyio;被 await 且**正常返回**的 monkeypatch 替身一律改 async
(仅 raise 的同步替身仍可用)。

门禁:ruff 全过 / pyright 0-0-0(standard 模式含 tests 与顶层模块)/ pytest
384 项全绿(0 失败 0 error 0 skipped;383→384 因 test_db_conn 拆用例)。
data/site.db 读写前后 sha256 一致(a19f5db…6487),无 -wal/-shm 边车残留。

下一步 B3:删 core/sync_http.py、core/async_bridge.py、core/http_errors.py 及
 tests/test_async_bridge.py——三者在生产侧已零消费者(http_errors 仅 sync_http
 自用,requests 已非声明依赖)。
2026-09-28 20:13:19 +08:00

116 lines
3.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# -*- coding: utf-8 -*-
"""FastAPI 鉴权依赖测试:会话解析、封禁/顶号拒绝、登录与管理员闸。"""
import sqlite3
import time
import pytest
import core.db as db
from core import session as cs
from web.deps import SiteUser, current_user, require_admin, require_login
from web.errors import AppError
SECRET = 'deps-test-secret'
async def _fake_secret_key() -> str:
"""web.deps.secret_key 已异步化:替身须为协程函数(否则 await 处 TypeError)。"""
return SECRET
@pytest.fixture()
def site(tmp_path, monkeypatch):
path = tmp_path / 'site.db'
conn = sqlite3.connect(str(path))
conn.executescript("""
CREATE TABLE users (id INTEGER PRIMARY KEY, username TEXT, role TEXT DEFAULT 'user',
status INTEGER DEFAULT 1, login_seq INTEGER DEFAULT 0,
duration_seconds INTEGER DEFAULT 0, ban_reason TEXT DEFAULT '');
INSERT INTO users (id, username, role, status, login_seq, duration_seconds)
VALUES (1,'qfbsh','admin',1,376,-1),
(26,'normal','user',1,5,97),
(27,'banned','user',2,1,0),
(28,'disabled','user',0,1,0);
""")
conn.commit()
conn.close()
monkeypatch.setattr(db, 'DATA_DIR', tmp_path)
monkeypatch.setattr(db, 'DB_PATH', path)
monkeypatch.setattr('web.deps.secret_key', _fake_secret_key)
return path
def _cookie(uid, seq, ts=None):
return cs.dumps(SECRET, {'site_uid': uid, 'site_uid_seq': seq,
'site_uid_ts': ts or int(time.time())})
async def test_valid_user(site):
u = await current_user(_cookie(26, 5))
assert u is not None and u.id == 26 and u.username == 'normal'
assert not u.is_admin and not u.unlimited
async def test_admin_unlimited(site):
u = await current_user(_cookie(1, 376))
assert u is not None and u.is_admin and u.unlimited
async def test_missing_cookie(site):
assert await current_user(None) is None
async def test_banned_rejected(site):
assert await current_user(_cookie(27, 1)) is None
async def test_disabled_rejected(site):
assert await current_user(_cookie(28, 1)) is None
async def test_stale_login_seq_rejected(site):
"""顶号:会话版本与库不一致 → 视为未登录。"""
assert await current_user(_cookie(26, 4)) is None
async def test_forged_cookie_rejected(site):
assert await current_user('not-a-valid-cookie') is None
async def test_expired_cookie_rejected(site, monkeypatch):
"""超龄会话 Cookie 由**服务端**拒绝(不只是浏览器层面的 max_age)。
Cookie 的 max_age 只是浏览器行为:被保存/复制的旧 Cookie 仍带着有效签名,
服务端不校验签发时间就等于登录态永不过期。
构造方式:用 monkeypatch.context() 把时钟拨回 SESSION_MAX_AGE 之前签发
(itsdangerous 的签名时间戳取自 dumps 时刻),再以当前时间解析。
必须用 context 而非 monkeypatch.undo()——后者会连带撤销 site fixture 的设置。
"""
past = time.time() - cs.SESSION_MAX_AGE - 60
with monkeypatch.context() as m:
m.setattr(time, 'time', lambda: past)
stale = _cookie(26, 5)
assert await current_user(stale) is None, '超龄会话必须被服务端拒绝'
fresh = await current_user(_cookie(26, 5))
assert fresh is not None and fresh.id == 26, '有效期内不受影响'
async def test_require_login_raises(site):
with pytest.raises(AppError) as ei:
await require_login(None)
assert ei.value.status_code == 401
async def test_require_admin_forbidden_for_user(site):
u = SiteUser(id=26, username='normal', role='user', credits=97)
with pytest.raises(AppError) as ei:
await require_admin(u)
assert ei.value.status_code == 403
async def test_require_admin_ok(site):
u = SiteUser(id=1, username='qfbsh', role='admin', credits=-1)
assert (await require_admin(u)).is_admin