一、它管的是"什么时候能查"

OnlineMode 位于主动缓存（ProactiveCaching）配置下，作用是：指定数据库是在缓存重建开始时立刻恢复在线，还是等缓存重建完成后才恢复在线。

二、两个取值，两种体验

关键判断：这份数据"看到旧值"和"暂时看不到"，哪个代价更大。

三、怎么选：按业务场景分

四、两个容易忽略的连带问题

默认值的隐性成本：默认 Immediate 意味着，如果不做任何配置，系统会在缓存重建期间就让用户进来查。一个从没被审视过的默认值，可能在你不注意的时候决定了数据可信度。

与其他缓存参数的配合：主动缓存不是单一开关，它还有延迟、通知方式等一组配置。OnlineMode 只决定"什么时候上线"，不决定"多久重建一次"。两者混在一起调，容易出现"配置改了但现象没变"的困惑。

五、落地建议

1. 先明确这份数据的"错误容忍度"——能否接受短暂的不一致；
2. 按上表选定模式，并写进文档，而不是靠默认值；
3. 对选择 OnCacheComplete 的库，评估重建耗时，确认可接受；
4. 在监控里区分"重建中的查询"和"正常查询"，否则性能问题会被误判。

一句话总结：这个参数回答的是"可用性和一致性，你先保哪个"。默认值选了可用性——如果你的业务更需要一致性，就得主动改。