Skip to content

2.1.4 — watchdog 性能优化:每刻全量查库归零

Choose a tag to compare

@ykcgly ykcgly released this 31 Oct 02:27
· 10 commits to main since this release

2.1.4 — watchdog 性能优化:每刻全量查库归零

一句话:watchdog 对「没有选中异火」的玩家负结果缓存不住,导致每 tick 完整走一遍 SQLite + 两次 File.exists——单人实测 8.2ms/刻、占主线程 16.4%,且复杂度 O(在线人数):6 个这样的在线玩家 TPS 就会掉到 12。本版把这条路径整体归零。

问题本体

YanhuoSelectionScript.watchdogTick(每刻任务)的选中状态缓存在 ConcurrentHashMap 里,它不允许 null——旧代码用 remove() 表示「没有」,结果下一刻 sel == null 又成立,负结果永远缓存不住:

  • 玩家有异火 → 缓存住 → 1 秒读 1 次 ✅
  • 玩家没有异火(新人、或清过选择)→ 每刻重查 ❌

单次成本拆解:prepareStatement(每次都让 SQLite 重新校验 schema)1.45ms + 目录 ensure 的 File.exists 0.90ms + 文件回落探测 0.54ms + 查询执行 0.51ms……乘以 22 个活跃窗口 × 26,400 次调用,总计 216 秒。

修复(六项)

  1. 负结果缓存(收益 ~20×):新增哨兵 NONE_SELECTED,「没选」也写进缓存;EARTH_ID.equals(哨兵) 恒为 false,非厚土玩家照旧跳过护血。
  2. 目录对象缓存:YANHUO_DIR 只在首次解析时建目录,之后不再每刻 stat。
  3. Store 读缓存(全插件受益):DOC_CACHE 缓存库里的原始 JSON 文本(含「确认没有」的负缓存)——缓存字符串而非解析后的 Map,load() 每次返回新副本,调用方就地修改不会污染缓存;save/delete 同步维护,shutdown 清空。
  4. 语句复用:Sqlite.select 按 SQL 文本复用 PreparedStatement(全局锁内天然串行),prepareStatement 从毫秒级降到微秒级;异常时踢出重建,close() 全部清理。
  5. 事件驱动失效:选中状态只在 setSelected()(玩家自选 / 挑战清空)里变化,那里主动失效缓存;TTL 从 1s 放宽到 30s 只作兜底。
  6. 快判:PlayerKeys 的 UUID 判定加长度短路;AddonPaths.docParts 的根路径 normalize() 也缓存了。

三个正确性保障(比提速更重要)

  • 查询异常不缓存:回库探测区分「正常无行」与「查询异常」,后者不写负缓存——否则一次瞬时 SQLite 故障会把「有档」永久固化成「没档」。
  • 二阶段挑战期短路:isPhaseTwoLocked 是纯内存查询,锁定期间直接按「未选中」处理、不读也不污染缓存,解锁后下一刻立即重读存档——30s TTL 不会拖慢「挑战结束异火恢复」。
  • 惰性迁移不受影响:ABSENT 命中时仍会回落读旧 JSON 文件,「文件→库」迁移语义不变。

预期收益

阶段 每 tick(1 名未选异火玩家) 相对现状
现状 8.2ms —
仅负结果缓存 0.41ms ↓20×
+ 目录缓存 + Store 读缓存 ≈0.03ms ↓270×
+ 30s TTL ≈0.001ms 归零

watchdogTick 从占用主线程 16.4% 降到 <0.05%,MSPT 中位数不变,但腾出了全部玩家扩展空间——这是开服前必须修的一条。

升级说明

直接替换 jar,无配置改动、无数据迁移。前提是本插件独占 tangran.db(目前 /tr import 也走本类,没有外部工具直写库)——若你用外部工具直接改库,需要重启才能看到新值。

校验:TangranTech-2.1.4-standalone.jar,7,297,744 字节。

验证方法

用一个没选异火的新号进服(最坏情况),挂 20 分钟 /spark profiler start:期望 watchdogTick 从 SELF-TIME 榜消失或 <0.05%。反向验证:选一次异火应立即生效,清空后被动应立即消失,二阶段挑战期间免死失效、结束后下一刻恢复。