feat(automation): 拆开「多久跑一次」与「同一账号多久重检」—— 调度频率终于可配
用户反馈:「单账号重检间隔(小时) 很别扭,直接设置多久跑一次、一次跑多少个更符合直觉」。
**对,而且比"别扭"更严重:调度频率以前根本改不了。**
## 问题:两个概念挤在一个字段里
`_run_one` 里原本写着:
job.next_run_at = finished + timedelta(seconds=JOB_INTERVAL_SECONDS) # 硬编码 300 秒
也就是不管界面上填什么,下一轮永远是「跑完 + 5 分钟」。
而界面那个「单账号重检间隔(小时)」对应的是 `interval_seconds` ——
它只被作业**自己的选行逻辑**使用("这行多久该重检"),**完全不参与调度**。
于是出现最坏的情况:**看起来能配调度,其实配的是一个不相干的参数**。
上一轮我还拿它算过吞吐("10 分钟一轮"),算错了 —— 已在调度器注释里纠正。
## 拆法
| 概念 | 字段 | 界面 |
| --- | --- | --- |
| **多久跑一次** | `run_interval_seconds`(迁移 0051,默认 300)| 「多久跑一次(分钟)」|
| 同一账号多久重检 | `interval_seconds`(不变)| 「同一账号多久重检(小时)」|
- `next_run_at = finished + run_interval_seconds`(有下限 30 秒,避免忙轮询)
- 接口:`GET` 返回新字段、`PATCH` 可改
- 前端:两个输入框分开,并把原来那段绕口的 tooltip
("它不决定调度频率 —— 调度周期见页面顶部说明")改掉 ——
那句话本身就是这个设计缺陷的自白
## 默认 300 秒
与改动前**实际行为一致** —— 不会因为这次迁移让已有作业突然变快或变慢。
想调快就自己填(比如「账号资料定时补全」填 5 分钟 + 每轮 400 条 ≈ 3 小时补完)。
## ⚠️ 顺带说明一个你截图里可能看到的现象
截图里「账号资料定时补全」显示的是 **0.5 小时 / 30 条** —— 那是我**最初的默认值**。
因为 `ensure_jobs` **只创建不更新**,我后面改成 10 分钟/400 **不会作用到已存在的行**。
这是刻意的(否则会覆盖运维的手工调整),但意味着**默认值改了要手动在界面上改**,
或者删掉那行让 `ensure_jobs` 重建。现在有了「多久跑一次」这个框,直接填就行。
## 测试(+3)
- 下一轮按**运行间隔**排,不是按「同一行重检间隔」(两个值刻意设成不同来钉住)
- 不填时默认 300 秒(保持旧行为)
- 过小的间隔被夹到下限
## 验证
TZ=Asia/Shanghai **639 passed / 6 skipped**;ruff 全绿;前端 build 通过、lint 0 errors。
This commit is contained in:
@@ -916,3 +916,81 @@ class TestSchedulerRunsJobsConcurrently:
|
||||
time.sleep(0.1)
|
||||
assert not scheduler._IN_FLIGHT, "失败后没清在途标记,作业会被永久跳过"
|
||||
assert calls, "作业应该真的跑过一次"
|
||||
|
||||
|
||||
class TestRunIntervalIsScheduling:
|
||||
"""「多久跑一次」与「同一行多久重检」是**两个独立概念**。
|
||||
|
||||
用户反馈:界面上那个「单账号重检间隔(小时)」很别扭,直接设「多久跑一次、
|
||||
一次跑多少个」更符合直觉 —— 对,因为**调度频率以前根本改不了**:
|
||||
|
||||
job.next_run_at = finished + timedelta(seconds=JOB_INTERVAL_SECONDS) # 硬编码 5 分钟
|
||||
|
||||
于是不管界面上填什么,下一轮永远是「跑完 + 5 分钟」。
|
||||
"""
|
||||
|
||||
def setup_method(self):
|
||||
self.engine = get_test_engine()
|
||||
self.session = make_test_session(self.engine)
|
||||
reset_registry()
|
||||
|
||||
def teardown_method(self):
|
||||
reset_registry()
|
||||
self.session.close()
|
||||
|
||||
def _job(self, run_interval: int | None):
|
||||
calls: list[int] = []
|
||||
|
||||
def probe(db, job):
|
||||
calls.append(1)
|
||||
return {"scanned": 1}
|
||||
|
||||
register_job(
|
||||
JobSpec(
|
||||
key="probe",
|
||||
title="probe",
|
||||
interval_seconds=6 * 3600, # 同一行重检间隔(不参与调度)
|
||||
batch_size=10,
|
||||
concurrency=1,
|
||||
run=probe,
|
||||
**({"run_interval_seconds": run_interval} if run_interval else {}),
|
||||
)
|
||||
)
|
||||
self.session.add(
|
||||
AutomationJob(
|
||||
key="probe",
|
||||
title="probe",
|
||||
interval_seconds=6 * 3600,
|
||||
run_interval_seconds=run_interval or 300,
|
||||
batch_size=10,
|
||||
concurrency=1,
|
||||
enabled=True,
|
||||
)
|
||||
)
|
||||
self.session.commit()
|
||||
return calls
|
||||
|
||||
def _next_run_delay(self) -> float:
|
||||
run_due_jobs(self.session)
|
||||
job = (
|
||||
self.session.query(AutomationJob).filter(AutomationJob.key == "probe").one()
|
||||
)
|
||||
assert job.last_run_at is not None and job.next_run_at is not None
|
||||
return (job.next_run_at - job.last_run_at).total_seconds()
|
||||
|
||||
def test_next_run_follows_run_interval_not_the_row_interval(self):
|
||||
"""下一轮按**运行间隔**排,不是按「同一行重检间隔」。"""
|
||||
self._job(run_interval=1800)
|
||||
delay = self._next_run_delay()
|
||||
assert delay == 1800, f"应按运行间隔 1800 排,实际 {delay}"
|
||||
assert delay != 6 * 3600, "不能再用「同一行重检间隔」当调度周期"
|
||||
|
||||
def test_default_run_interval_keeps_old_behaviour(self):
|
||||
"""不填时默认 300 秒 —— 与改动前的硬编码行为一致(不会突然变快变慢)。"""
|
||||
self._job(run_interval=None)
|
||||
assert self._next_run_delay() == 300
|
||||
|
||||
def test_too_small_interval_is_clamped(self):
|
||||
"""太小的间隔是忙轮询,没有意义 —— 有下限。"""
|
||||
self._job(run_interval=1)
|
||||
assert self._next_run_delay() >= scheduler.MIN_RUN_INTERVAL_SECONDS
|
||||
|
||||
@@ -26,7 +26,7 @@ TESTS_DIR = Path(__file__).resolve().parent
|
||||
PROJECT_ROOT = TESTS_DIR.parent
|
||||
VERSIONS_DIR = PROJECT_ROOT / "web" / "backend" / "migrations" / "versions"
|
||||
|
||||
HEAD_REVISION = "20261004_0050"
|
||||
HEAD_REVISION = "20261004_0051"
|
||||
|
||||
# 迁移新增、但不声明在模型里的复合查询索引。
|
||||
EXTRA_INDEXES = (
|
||||
|
||||
Reference in New Issue
Block a user