Camel中PLC4X Modbus端点字符串URI配置空指针问题排查与求解

问题背景 #

使用ModbusPal搭建虚拟Modbus服务，采用以下字符串形式的PLC4X端点URI配置Camel路由时，启动上下文抛出NullPointerException：

plc4x:modbus-tcp://localhost:502?unitId=1&dataType=holding-register&addresses=1

报错栈信息：

java.lang.NullPointerException
    at org.apache.camel.component.plc4x.Plc4XConsumer.startUnTriggered(Plc4XConsumer.java:89)
    at org.apache.camel.component.plc4x.Plc4XConsumer.doStart(Plc4XConsumer.java:81)
    at org.apache.camel.support.service.BaseService.start(BaseService.java:119)

调试确认问题根源是代码中tags变量为空，说明端点配置不符合组件要求。但通过手动实例化Plc4XEndpoint并设置tags的方式可以正常运行：

Map<String, Object> map = new HashMap<>();
map.put("value-1", "holding-register:1");

Plc4XEndpoint plc4xEndpoint = new Plc4XEndpoint("plc4x:modbus-tcp://localhost:502",
        getContext().getComponent("plc4x"));
plc4xEndpoint.setTags(map);
from(plc4xEndpoint).log("value : ${body}");

当前使用版本：Camel核心3.20.2，Camel-PLC4X 3.20.2

问题解答 #

1. 原配置无效的原因 #

你使用的dataType和addresses并非Camel PLC4X组件的标准配置参数。该组件要求通过tags参数来定义需要访问的PLC点位映射，而非拆分的dataType和addresses参数，因此原配置无法正确初始化tags变量，导致空指针异常。

2. 正确的端点URI写法 #

需要将点位映射定义在tags参数中，格式为自定义键=数据类型:地址，多个点位用逗号分隔。针对你的场景，正确的URI如下：

plc4x:modbus-tcp://localhost:502?unitId=1&tags=value-1=holding-register:1

说明 #

Camel PLC4X组件通过tags参数解析需要访问的PLC资源，每个标签的键是自定义的名称（用于在路由中引用），值遵循数据类型:地址的格式，这样组件才能正确识别并初始化点位信息，避免因tags为空引发的空指针问题。

内容的提问来源于stack exchange，提问作者mdanish98