# 流量、预订结果及通知可靠性审查 > 本文为修复前的历史审查结论。后续修复及运行说明见 [reliability-fixes.md](reliability-fixes.md);reproduce.py 现已运行修复后的回归测试。 审查日期:2026-10-25(Asia/Shanghai)。范围:本地 coordinate 代码、Compose 和配置文件。 结论:存在能造成流量放大、成功状态遗漏、通知丢失、slot 信号丢失及错误成功上报的路径。以下区分代码缺陷和部署条件;没有证据证明已经发生实际扣费、重复预约或漏单。 本次仅新增报告和离线复现脚本,没有修改生产代码、配置或启用服务。没有调用真实预约、通知、代理或云端接口;复现脚本阻止 socket.connect。 ## 发现及修复方向 ### 1. [P1] 代理端口对宿主机外部发布,配置无认证 - 位置:`docker-compose.yml:19-24`、`config/mihomo_config.yaml:1-2`。 - Compose 发布 `16000` 和 `16001-16350`,未指定宿主机绑定地址;配置 `allow-lan: true`,未设置全局 authentication;306 个 listener 均未设置 users 或显式 listen 地址。 - 如果部署主机的网络和防火墙允许其他人接入,这些端口可成为消耗付费出口流量的入口。仅凭代码不能判断公网可达性,本次未做网络扫描。 - 建议:业务容器优先通过内部网络连接;宿主机需要访问时绑定回环或明确的内网地址,跨主机连接配置认证和来源限制。 - 验证:静态检查 Compose、解析实际 YAML;未验证外部可达性。 ### 2. [P1] VFS 默认结束日期为 2100 年,单次预订可能查询数百个月 - 位置:`plugins/vfs_plugin.py:991-992,1064-1077,1550-1576`。 - 当 user_inputs 未提供 expected_end_date,默认到 `2100-01-01`。`_get_filtered_covered_months` 生成整个范围;每个月都调用 `_query_slot_calendar`,直到找到可用时间或结束。 - 离线输入 earliest=`2026-10-25`、未限制结束日期,对应 **880 个月**。若日历持续返回空数据而不是错误,单次 book 可产生 880 次日历请求,另加配置、申请人和日期时间查询;遇到限流异常会提前退出,并非每次必定达到上限。 - 旧信号重复触发及多个实例会进一步放大请求量。 - 建议:缺省限制为合理预约窗口,增加单次最大查询月数、请求总量和耗时上限;无有效窗口应拒绝预订或要求明确配置。 - 复现:`test_vfs_default_range_scans_hundreds_of_months`。 ### 3. [P1] 最终提交响应不确定时,会被当作可重试失败;GRC 还自动重放 POST - 位置:`booker.py:658-678`、`main_sweeper.py:_rescue_task`、`plugins/vfs_plugin.py:1125,1453-1475`、`plugins/grc_plugin.py:627-642`。 - 网站已接受最终预订、但客户端读响应超时,插件无法返回 BookResult(success=True),因此不会写成功 outbox。Builtin Booker 将 tracker 的 deadline 直接设为当前时间,Sweeper 见云端仍为 processing 时会归还队列;没有针对网站预约状态的确认步骤。Order/Standalone 也没有明确的“提交结果不确定,暂停重试”状态。 - GRC 的通用请求方法对所有方法捕获异常后重试,包含最终提交 POST,最多发送三次相同请求。服务端是否幂等未知,客户端没有幂等键或查单保护,存在重复提交风险,不能直接断言网站一定产生多个预约。 - 建议:提交前持久化意图;区分“明确拒绝”和“结果未知”。未知状态先查预约记录或进入人工核对,禁止自动回队列;最终提交不套用通用 POST 重试。 - 复现:`test_uncertain_builtin_booking_becomes_immediately_rescuable`、`test_grc_replays_mutating_post_after_uncertain_response`。模拟服务端已提交而响应丢失,没有执行真实预订。 ### 4. [P1] Standalone 成功结果没有持久化,而且成功后继续循环预订 - 位置:`standalone.py:411-432`。 - book 返回成功后只调用异步通知和日志,等待 5 秒,随后重新安排下一次查询。没有写 BookingOutbox、本地成功记录或持久化完成标志,也不停止该账号的预订。 - 通知失败或进程退出可能只留下日志;相同 slot 再次被查到时仍调用 book。网站若拒绝重复预约,只会产生无效请求;若允许,存在重复预约风险。 - 建议:Standalone 也保存成功结果和通知事件,按任务/账号记录完成状态;完成后停止或明确消费下一项授权任务,支持重启恢复。 - 复现:`test_standalone_continues_booking_after_success`,连续两次 book 均成功,第一次成功后仍触发第二次调用。 ### 5. [P1] 通知队列拒绝或接口失败后,没有可靠补发 - 位置:`toolkit/notifier.py:25,37-43,74-81`、`toolkit/task_executor.py:TaskExecutor.submit`、`booker.py:536-544`、`utils/booking_outbox.py:flush`。 - TaskExecutor 满载会返回 False,两个 notify 函数都忽略返回值并返回 True。通知与代理探测、信誉同步、指标上报共用后台执行器,非通知任务也会占用容量。 - 微信接口失败只记日志,没有持久化重试。后台线程是 daemon,进程退出时未发送完的事件也没有恢复机制。 - Booker 的成功 outbox 能重试云端订单更新,但没有通知待发/已发送字段;重启后的 flush 不会重放成功通知。因此“订单最终记录成功”并不保证“通知最终送达”。 - 建议:持久化通知事件、接收对象和幂等标识,独立重试并保存送达状态;至少应显式检查队列拒绝,不能把排队失败当作成功。 - 复现:`test_full_queue_silently_drops_both_notification_types`。 ### 6. [P2] slot 通知去重提前生效,恢复同日档期和 Waitlist 会漏通知 - 位置:`toolkit/notifier.py:16-25,37-43`、`plugins/vfs_plugin.py:597-603`。 - 入队前就缓存 earliest_date。第一次发送失败后,相同日期一直被抑制;这是第五项故障在 slot 通知上的持续影响。 - 无 slot 时直接 return,不清除“已通知日期”。同一日期从有号 → 无号 → 恢复,后一次不会再通知;相同最早日期下新增时间或其他日期也不触发通知。 - VFS Waitlist 的 success=True 但没有 earliest_date,notify_date_changes 会直接忽略。这是实际可预订状态与“仅通知日期变化”的覆盖差异。 - 建议:比较可用状态和 slot 集合,区分事件去重与送达去重;恢复可用时形成新事件;Waitlist 使用独立通知内容。 - 复现:`test_push_failure_is_not_retried_for_same_date`、`test_closed_then_reopened_same_date_is_not_notified`、`test_waitlist_without_date_is_not_notified`。 ### 7. [P1] Redis 信号发布失败被忽略;无号结果也不会撤销旧信号 - 位置:`sentinel.py:340-356`、`utils/safe_redis_cli.py:setex/_safe_execute`、`booker.py:473-516`。 - SafeRedisClient 在两次写失败后返回 False,Sentinel 不检查返回值,正常安排下一次查询。可能出现“已检测/已排通知,但 Booker 完全没收到信号”;下一次查询前没有保存并重试这次 slot。 - 一次有号信号发布后,后续无号结果既不覆盖也不删除旧值。Booker 按 cooldown 重复读取旧信号,没有按 slot 事件去重或检查外层 timestamp;旧值会持续到 TTL 到期。失败后持续请求已消失的档期,尤其会放大 VFS 扫月开销。 - 当前本地 Sentinel TTL 为 30 秒;代码默认 TTL 为 180 秒。真实运行值取决于云端配置。TTL 内重试次数还受 book 耗时、cooldown 和实例数影响。 - 建议:保存有版本和有效期的信号,发布失败重试并告警;发布明确的无号状态,按新鲜度校验后消费;多 Sentinel 时不能直接无条件删除其他实例刚发布的新信号。 - 复现:`test_failed_signal_publish_is_treated_as_completed_query`、`test_no_slot_does_not_retract_previous_signal`。 ### 8. [P1] USA 插件点击提交即返回成功,没有网站确认 - 位置:`plugins/usa_plugin.py:698-712`。 - 调用鼠标点击后直接 success=True,没有验证响应、确认页或预约编号。页面校验不通过、网站拒绝、提交还未完成时,也可能上报 grabbed,通知用户并退役实例,造成漏订和错误记录。 - 建议:点击后等待并验证网站的权威确认结果;拒绝返回失败,超时进入结果不确定状态;保存确认凭据后再完成订单。 - 复现:`test_usa_reports_success_without_server_confirmation`。 ## 另外核对到的配置与功能边界 1. **本地配置没有启用预订消费者。** `config_booker.yaml` 三组、`config_standalone.yaml` 五组均 enable=0;Sentinel 启用的是 vfs.ie.at、vfs.ie.nl、vfs.ie.hu。使用这些本地配置时不会自动预订;即使启用现有 Booker,也没有覆盖 AT/HU 的路由配置。**Compose 启动命令未传 --config,main.py:285-287 默认使用云端配置**,因此这不是对当前线上运行状态的结论,需核对云端实际下发的组与路由。 2. **部分插件尚未实现预订。** `plugins/bel_plugin.py:270-272`、`plugins/pol_plugin.py:369-372` 的 book 直接返回默认失败;`plugins/prt_plugin.py:40-44` 的 query/book 均为空实现。启用这些插件不会完成真实预订。 3. **Italy 最终提交有显式开关。** `plugins/ita_plugin.py:1987-1991` 仅在 final_submit_enabled is True 时提交;本地 Italy 组禁用,且该开关为 False。这属于配置行为,不当作默认自动修复项。 4. **已有保护并非完全缺失。** Booker 有 SQLite 成功 outbox、Redis 成功 marker、独立订单心跳及并发控制;现有测试验证了部分云端/Redis故障恢复。上述第三、四、五项分别发生在成功结果返回前、Standalone 分支、通知交付阶段,绕过或超出了这些保护。 5. **没有调用 slot_snapshot_report。** 仓库仅找到 CloudApi 中的方法定义,检测主链路目前不调用。如果还要求云端/UI 保存每次 slot 快照,需要补齐生产端及确认服务端消费约定;本次未检查服务端,不能据此断言其 UI 一定不更新。 ## 验证及复现 现有测试:69 项,68 通过,1 项 POSIX 信号测试在 Windows 跳过。执行命令: ```powershell .\venv\Scripts\python.exe -X utf8 -m unittest discover -s test -p 'test_*.py' ``` 新增离线审查复现:11 项全部复现当前缺陷。**这里的 OK 表示已观察到报告中的问题,不表示缺陷已修复。** ```powershell .\venv\Scripts\python.exe -X utf8 docs/audits/2026-10-25/reproduce.py ``` ## 建议顺序 1. 核对代理端口的实际可达性并限制入口;限制 VFS 扫描范围。 2. 引入最终提交的结果不确定状态和查单流程,移除最终提交的盲目 POST 重试;修正 USA 成功判定。 3. Standalone 成功持久化并停止重复预订;为通知添加独立持久化补发机制。 4. 修复通知去重、信号发布确认与失效语义;核对云端启用的消费者及路由覆盖。 本次未测量实际出入站字节量、代理计费、真实预约接口或微信最终送达;11 项复现证明客户端控制流缺陷,不能替代部署和第三方接口的端到端验收。