reliability-fixes.md 4.4 KB

可靠性修复及运行说明

当前存储方式

新增的通用本地存储模块及依赖它的人工核对脚本已移除。当前只保留原有 BookingOutbox 用于订单结果同步,不新增通知、slot 或预约保护的 SQLite 数据库。

  • 通知待发送队列和日期/时段去重状态只放在进程内存中。slot 信号不再使用待发送缓存,查询完成后直接写入 Redis。
  • 通知队列独立于遥测执行器,最多 256 项,失败后退避 5~300 秒重试;满载返回失败并记录日志,不提前更新 slot 去重状态。
  • 进程退出会丢失这些内存队列和去重状态;不保证重启后的通知补发。已清空的订单 outbox 也不能恢复尚未发送的内存通知。
  • Standalone 只在当前进程记住成功状态,并停止当前任务的重复预订;重启会忘记完成状态。
  • 订单模式保留原有订单 outbox 及成功结果的 Redis 同步标记。最终提交前的 Redis 占位、提交边界标记和结果未知自动暂停策略已移除。
  • 原有数据库 data/booking_outbox.sqlite3 继续通过 BOOKING_OUTBOX_PATH 配置并持久保存。
  • 历史存储文件未自动销毁,但运行代码不再读取或写入它们;Git/Docker 中保留历史文件的忽略项,防止误提交或打入镜像。

保留的修复

问题 当前行为
代理流量被他人消耗 Compose 只发布宿主机 127.0.0.1;本机启动默认将主监听及所有独立监听绑定回环地址。原始配置不改写,运行配置位于 logs/mihomo.runtime.yaml。容器内部网络仍可访问。
VFS 扫描数百个月 单次最多扫描有效起始月份后的 6 个月;即使结束日期为 2100 年也不能绕过。
提交调用与异常 Booker/Standalone 直接调用插件 book 方法。提交边界与结果未知的专用处理已移除,异常交由现有错误处理和重试流程;GRC 仍不自动重放 POST。
Standalone 成功后继续预订 在当前进程记录完成状态,释放浏览器并停止该任务;此状态不跨重启保存。
通知满载或发送失败 独立内存队列,检查容量,进程存活期间重试。无法承诺跨重启恢复。
slot 恢复、Waitlist 漏通知 比较状态、日期及时段;同日恢复、时段变化、Waitlist 都可通知。队列拒绝时不更新去重缓存。
Redis 信号发送 查询完成后直接 setex 写入 Redis,无后台补发队列。SafeRedisClient 原有的单次失败重试保留;无号结果仍发布不可用状态,消费者仍忽略过期/不可用信号。
USA 点击提交即错报成功 等待确认路径及匹配的预约日期。无权威确认则抛出普通业务异常,不冒报成功。实际站点页面仍需部署验收。

新增的 slot 快照上报、信号重试后台循环及待发送缓存已移除;Sentinel 只启动原有的检测和实例创建线程,不再额外上报云端快照。BEL/POL/PRT 的空预订实现仍在启动阶段报错,避免领取账号/订单后空转。检测间隔至少 1 秒,booking_cooldown 和 signal_ttl 必须为正数。

配置和结果核对

本次没有启用真实下单组或更改云端订单。消费者需要启用、匹配 routing_key,并配置正确的账号/订单来源。无启用组时启动日志会明确提示不会触发预订;Italy 的最终提交开关保持原配置。

最终提交的结果跟踪辅助模块已删除,不再创建或消费专门的结果未知 Redis 标记。最终提交响应超时会走现有失败处理流程;成功记录仍由 BookingOutbox 同步。

Standalone 的 booking_run_id 可区分当前进程中明确授权的新任务;单纯修改日期不会跳过进程内的完成保护,重启则不保留该保护。

改动需部署重启后生效。跨主机访问代理仍需显式配置受控入口;同一 Compose 内访问 proxy 服务名不受宿主机回环发布的影响。真实官网预约、云端接口及微信最终送达尚未执行端到端验收。

验证

.\venv\Scripts\python.exe -X utf8 -m unittest discover -s test -p 'test_*.py'
.\venv\Scripts\python.exe -X utf8 docs/audits/2026-10-25/reproduce.py
docker compose config --quiet

回归测试已移除新增本地存储的持久化场景,覆盖保留的流量限制、内存通知重试与拒绝、slot 状态变更、直接信号发布、订单 outbox 和进程内 Standalone 完成保护。