You need to enable JavaScript to run this app. OPC UA Milo 服务器断开重启后的重订阅实现与订阅转移失败处理咨询
优惠活动
大模型
产品
解决方案
定价
更多

OPC UA Milo 服务器断开重启后的重订阅实现与订阅转移失败处理咨询

Eclipse Milo OPC UA客户端重订阅逻辑实现指南

问题背景

在使用Eclipse Milo开发OPC UA客户端时,常遇到服务端重启、网络链路中断导致原有订阅失效的问题,需要结合框架原生能力设计可靠的重订阅逻辑。
初始版本的单节点订阅实现如下:

private CompletableFuture<DataValue> subscribe(NodeId nodeToSubscribe, double samplingInterval, Consumer<DataValue> onChangeDo){
    CompletableFuture<DataValue> result = new CompletableFuture<>();
    try{
        // 配置订阅参数
        ManagedSubscription subscription = ManagedSubscription.create(client, samplingInterval);
        subscription.setDefaultSamplingInterval(samplingInterval);
        subscription.setDefaultQueueSize(uint(10));

        // 注册数据变化触发回调
        ManagedDataItem managedDataItem = subscription.createDataItem(nodeToSubscribe, item -> item.addDataValueListener(onChangeDo));

        // 等待首次数据上报完成
        ManagedDataItem.DataValueListener listener = managedDataItem.addDataValueListener(result::complete);
        result.whenComplete((v,e) -> managedDataItem.removeDataValueListener(listener));
    } catch (UaException e){
        result.completeExceptionally(e);
    }

    return result;
}

该版本在正常连接场景下可以稳定运行,但一旦出现服务端重启、客户端与服务端连接断开的情况,之前创建的所有订阅都会直接失效。

第一版重连重订阅尝试

最初的重订阅实现是通过会话活动监听器感知连接状态变化,在状态变更时手动清理、重建全量订阅,核心代码如下:

addSessionActivityListener(new SessionActivityListener(){
    @Override
    public void onSessionActive(UaSession session) {
        log.info("Connecting PLC with IP address {}",ipAddress);
        setConnectionStatus(ConnectionStatus.CONNECTED);
        subscribeAll();
    }

    @Override
    public void onSessionInactive(UaSession session) {
        log.info("Disconnecting PLC with IP address {}",ipAddress);
        setConnectionStatus(ConnectionStatus.DISCONNECTED);
        uaClient.getSubscriptionManager().clearSubscriptions();
    }
});

这种实现方式可以满足基础的断连重订阅需求,但没有结合Milo框架本身的机制特性,存在重复触发、状态不同步的风险。

结合Milo原生机制的优化方案

结合Milo维护者的技术说明可以了解到,框架本身内置了订阅转移逻辑:当客户端与服务端的会话重新建立时,框架会自动尝试将之前的订阅迁移到新的会话上,无需开发者手动干预。

但这套机制需要服务端支持对应的能力,如果服务端不支持,订阅转移流程会直接失败,并打印如下日志:

ON SUBSCRIPTION TRANSFER FAILED: subscription org.eclipse.milo.opcua.sdk.client.subscriptions.OpcUaSubscription@3f344a79, status code StatusCode{name=Bad_ServiceUnsupported, value=0x800B0000, quality=bad}

从日志中的状态码Bad_ServiceUnsupported可以判断,当前对接的服务端没有实现订阅转移的相关服务,框架的自动转移逻辑无法生效。

订阅转移失败的适配实现

针对不支持订阅转移的服务端场景,Milo提供了专门的失败回调接口,可在订阅转移失败时手动触发重订阅流程,基础实现如下:

uaClient.getSubscriptionManager().addSubscriptionListener(new UaSubscriptionManager.SubscriptionListener() {
    @Override
    public void onSubscriptionTransferFailed(UaSubscription subscription, StatusCode statusCode) {
        uaClient.getSubscriptionManager().clearSubscriptions();
        subscribeAll();
    }
});

现有实现的可优化点

目前基于订阅转移失败回调实现的重订阅流程可以正常运行,结合工程落地经验,还有几个细节可以进一步优化:

  • 增加幂等判断:clearSubscriptions和subscribeAll操作需要加状态锁或幂等标记,避免网络闪断导致同一时刻多次触发重复订阅,造成资源浪费
  • 打通状态同步链路:清理旧订阅、创建新订阅的操作需要和会话状态回调逻辑联动,避免出现会话已标记为连接、但订阅创建未完成的状态窗口
  • 增强批量流程的容错能力:subscribeAll流程内的单个节点订阅操作需要单独捕获异常,避免单个节点订阅失败导致整个批量重订阅流程中断

内容的提问来源于stack exchange,提问作者Jakub Znamenáček

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 21:15:10