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
相关产品推荐
相关产品推荐

