当前位置:

首页 > 编程开发 > MongoDB 变更流暂停与恢复实战教程

MongoDB 变更流暂停与恢复实战教程

本文详解如何在SpringReactiveMongoDB应用中动态停止并安全恢复变更流,利用Disposable控制订阅生命周期,并结合ResumeToken实现断点续传,适用于数据库维护等场景。

本文目录

    MongoDB 变更流(Change Stream)的暂停与恢复实战指南

    本文详解如何在 Spring Reactive MongoDB 应用中动态停止并安全恢复变更流,利用 Disposable 控制订阅生命周期,并结合 Resume Token 实现断点续传,适用于数据库维护等场景。

    本文详解如何在 Spring Reactive MongoDB 应用中动态停止并安全恢复变更流,利用 Disposable 控制订阅生命周期,并结合 Resume Token 实现断点续传,适用于数据库维护等场景。

    在响应式 MongoDB 开发中,变更流(Change Stream)是监听集合数据实时变更的核心机制。但生产环境中常需临时中断流(例如执行索引重建、批量迁移或备份),之后从中断位置精准续订,而非丢失事件或重放全量历史。Spring Data MongoDB 的 ReactiveMongoTemplate.changeStream(...) 返回的是 Flux,其本质是冷流(cold stream),每次订阅都会新建一次服务端游标——因此“暂停”不能靠阻塞线程实现,而必须通过取消订阅 + 保存/复用 Resume Token 完成。

    ✅ 正确做法:取消订阅 + 基于 Token 恢复

    Flux.subscribe() 返回 Disposable,调用 .dispose() 即可立即终止当前流订阅,释放客户端资源(注意:它不会自动通知 MongoDB 服务端关闭游标,但后续无心跳将由服务端超时清理,符合预期):

    // 启动变更流并持有 Disposable 引用
    private volatile Disposable currentSubscription;
    private volatile BsonValue lastResumeToken;
    
    public void startWatching() {
        currentSubscription = reactiveMongoTemplate
            .changeStream("collection", 
                ChangeStreamOptions.builder()
                    .returnFullDocumentOnUpdate()
                    .build(), 
                Example.class)
            .filter(event -> event.getOperationType() != null)
            .doOnNext(event -> lastResumeToken = event.getResumeToken()) // 关键:持续更新 token
            .mapNotNull(ChangeStreamEvent::getBody)
            .subscribe(
                example -> exampleService.doSomething(example),
                error -> log.error("Change stream error", error),
                () -> log.info("Change stream completed")
            );
    }
    
    public void stopWatching() {
        if (currentSubscription != null && !currentSubscription.isDisposed()) {
            currentSubscription.dispose();
            log.info("Change stream stopped. Last resume token: {}", lastResumeToken);
        }
    }

    ? 恢复流:从上次 Token 续订

    MongoDB 要求恢复时传入 resumeAfter(非 startAfter),且该 token 必须来自同一流上下文(即同一集合、相同聚合管道)。恢复代码示例如下:

    public void resumeWatching() {
        if (lastResumeToken == null) {
            log.warn("No valid resume token available; starting from latest");
            startWatching(); // 退化为新流
            return;
        }
    
        // 构建带 resumeAfter 的选项
        ChangeStreamOptions options = ChangeStreamOptions.builder()
            .returnFullDocumentOnUpdate()
            .resumeAfter(lastResumeToken) // ⚠️ 核心参数
            .build();
    
        currentSubscription = reactiveMongoTemplate
            .changeStream("collection", options, Example.class)
            .filter(event -> event.getOperationType() != null)
            .doOnNext(event -> lastResumeToken = event.getResumeToken())
            .mapNotNull(ChangeStreamEvent::getBody)
            .subscribe(
                example -> exampleService.doSomething(example),
                error -> {
                    log.error("Resume failed, falling back to new stream", error);
                    // 可选:自动降级为新流(如 token 过期)
                    startWatching();
                }
            );
    }

    ⚠️ 关键注意事项

    • Token 时效性:MongoDB 默认保留变更流 token 最多 5 分钟(可通过 maxAwaitTimeMS 和副本集 oplog 大小间接影响),超时后 resumeAfter 将抛出 MongoCommandException(code=234)。生产环境建议捕获该异常并优雅降级。
    • 线程安全:lastResumeToken 需用 volatile 修饰,且读写应加锁或使用 AtomicReference 避免竞态。
    • 不支持 pause() / resume() 方法:Reactor 的 Flux 本身无内置暂停语义;所谓“暂停”本质是取消+重建,务必依赖服务端 Resume Token 实现语义连续性。
    • 避免重复消费:resumeAfter 是严格大于指定 token 的首个事件,因此不会重复投递已处理事件,满足 exactly-once 语义前提(需业务层配合幂等设计)。

    ✅ 总结

    变更流的“暂停-恢复”不是客户端流控,而是服务端游标生命周期管理。核心路径为:
    ① 订阅时持续提取 event.getResumeToken() 并持久化(如内存缓存或 Redis);
    ② 停止时调用 Disposable.dispose();
    ③ 恢复时构造 ChangeStreamOptions.resumeAfter(token) 重建流。
    只要 token 有效,即可实现毫秒级断点续传,完美支撑运维灰度与弹性扩缩容场景。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Codex 0.171.0-alpha.10 的只读预览能在终端看到什么?
    Codex 0.171.0-alpha.10 的只读预览能在终端看到什么?

    Codex 0.171.0-alpha.10 预发布版增加终端侧栏的只读文档预览。启用工作区后,当前线程中可解析的文件链接能形成预览标签页。

    Codex 0.170.0-alpha.4.1 预发行如何关闭 Bedrock 增量工具声明?
    Codex 0.170.0-alpha.4.1 预发行如何关闭 Bedrock 增量工具声明?

    Codex 0.170.0-alpha.4.1 预发行默认在两种 Amazon Bedrock provider 上走增量工具定义,保留显式关闭选项。

    Codex 0.171.0-alpha.11 的侧栏怎样呈现会话文件与图片?
    Codex 0.171.0-alpha.11 的侧栏怎样呈现会话文件与图片?

    Codex 0.171.0-alpha.11 为终端侧栏增加会话文件入口和图片预览。选择器负责发现文件,预览根据文件类型和终端能力决定显示方式。

    Codex 0.171.0-alpha.8 预发行的远程执行和线程恢复怎么用?
    Codex 0.171.0-alpha.8 预发行的远程执行和线程恢复怎么用?

    Codex 0.171.0-alpha.8 预发行允许 exec 连接现有应用服务器,说明 WebSocket 认证、服务端配置与线程恢复限制。

    Cursor 的 Hospitable 1.0.0 怎么分清日历查询和预订修改?
    Cursor 的 Hospitable 1.0.0 怎么分清日历查询和预订修改?

    从 Cursor 3.13.0 起可添加 Hospitable 1.0.0 插件,检查只查、编辑、取消和发送住客消息的适用条件。

    Cursor Close 插件 1.0.0 的只读、安全写入和删除权限怎么区分?
    Cursor Close 插件 1.0.0 的只读、安全写入和删除权限怎么区分?

    Cursor Close 插件 1.0.0 要求 Cursor 3.13.0 起,说明聊天添加命令、单组织连接以及三种账号授权范围。 Cursor 的 Close 1.0.0 把查询、创建和更新删除分到三个授权等级。只需要查看线索时,只读授权能覆盖查询场景。

    Cursor Redo 插件 1.0.0 如何理解店铺接入和退货操作权限?
    Cursor Redo 插件 1.0.0 如何理解店铺接入和退货操作权限?

    Cursor Redo 插件 1.0.0 要求 Cursor 3.13.0 起,说明聊天添加命令、商家授权及订单查询与退货写入的区别。 Redo 1.0.0 可通过 Cursor 添加到商家工作环境。接入后,订单查询与退货处理取决于对应的店铺账号和角色。

    Qwen Code TypeScript SDK v0.1.35 和 CLI v0.28.0 有什么关系?
    Qwen Code TypeScript SDK v0.1.35 和 CLI v0.28.0 有什么关系?

    Qwen Code TypeScript SDK v0.1.35 正式版同捆 CLI v0.28.0,适用 Node.js 22.0.0 以上,安装状态以 npm 注册表为准。

    llama.cpp b12470 修复了哪些 SYCL Flash Attention 掩码广播错误?
    llama.cpp b12470 修复了哪些 SYCL Flash Attention 掩码广播错误?

    llama.cpp b12470 预发布构建修复了 SYCL 后端使用 MKL 的 Flash Attention 路径。掩码按注意力头或批次广播时,会避免对较小掩码维度直接越界读取。

    Qwen Code v0.28.0 默认在哪些场景启用共享 Agent 循环?
    Qwen Code v0.28.0 默认在哪些场景启用共享 Agent 循环?

    Qwen Code v0.28.0 将共享 Agent 循环默认用于无界面会话、Ink 终端和子代理。各入口在没有显式配置时采用自己的默认值。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。