PLC4J OPC UA无发现服务器加密连接时receiverCertificateThumbprint为空问题

问题分析 #

触发的NullPointerException核心原因是：在跳过发现服务器（discovery=false）的直连场景下，receiverCertificateThumbprint未被初始化。该值仅在通过发现服务器调用onDiscoverGetEndpointsRequest()方法时才会生成并赋值，直连时这一流程被跳过，导致后续加密握手阶段引用空值。

可行解决方案 #

方案1：手动生成并注入证书指纹 #

在建立连接前，手动计算本地证书的SHA-1指纹并注入到DriverContext中，模拟发现流程的指纹生成逻辑：

// 加载密钥库获取客户端证书
KeyStore keyStore = KeyStore.getInstance("JKS");
try (FileInputStream fis = new FileInputStream(keyStoreFile)) {
    keyStore.load(fis, keyStorePassword.toCharArray());
}
// 替换为你的密钥库中客户端证书的别名
Certificate clientCert = keyStore.getCertificate("plc4x-client-cert");

// 计算SHA-1指纹
MessageDigest md = MessageDigest.getInstance("SHA-1");
byte[] thumbprintBytes = md.digest(clientCert.getEncoded());
PascalByteString thumbprint = new PascalByteString(thumbprintBytes.length, thumbprintBytes);

// 获取PLC4J驱动上下文并设置指纹
OpcuaDriver opcuaDriver = (OpcuaDriver) PlcDriverManager.getDefault().getDriver("opcua");
OpcuaDriverContext driverContext = opcuaDriver.getDriverContext();
driverContext.setThumbprint(thumbprint);

// 执行原有连接逻辑
String connectionString = String.format("opcua:tcp://%s:%d?discovery=%b", host, port, discovery);
// 拼接其他参数...
try (PlcConnection connection = PlcDriverManager.getDefault().getConnectionManager().getConnection(connectionString)) {
    // 业务逻辑
}

方案2：临时触发发现流程初始化指纹 #

先通过发现服务器建立一次临时连接（仅用于初始化指纹），再切换到直连模式：

// 1. 临时启用发现流程，触发指纹初始化
String discoveryConnStr = String.format("opcua:tcp://%s:%d?discovery=true&securityPolicy=%s&keyStoreFile=%s&keyStorePassword=%s", 
    host, port, securityPolicy, keyStoreFile, keyStorePassword);
try (PlcConnection tempConn = PlcDriverManager.getDefault().getConnectionManager().getConnection(discoveryConnStr)) {
    // 无需执行业务操作，仅完成发现流程即可
}

// 2. 用discovery=false建立直连
String directConnStr = String.format("opcua:tcp://%s:%d?discovery=false&username=%s&password=%s&securityPolicy=%s&keyStoreFile=%s&keyStorePassword=%s", 
    host, port, username, password, securityPolicy, keyStoreFile, keyStorePassword);
try (PlcConnection connection = PlcDriverManager.getDefault().getConnectionManager().getConnection(directConnStr)) {
    // 业务逻辑
}

方案3：修复PLC4J框架源码 #

这是框架的场景覆盖BUG，直连加密场景缺少指纹初始化逻辑：

1. 修改org.apache.plc4x.java.opcua.context.SecureChannel类，在直连的握手初始化方法（如connect()）中添加指纹生成代码，参考发现流程中的逻辑：

// 在直连握手逻辑前插入
try {
    MessageDigest messageDigest = MessageDigest.getInstance("SHA-1");
    byte[] digest = messageDigest.digest(driverContext.getSenderCertificate());
    driverContext.setThumbprint(new PascalByteString(digest.length, digest));
} catch (NoSuchAlgorithmException e) {
    LOGGER.error("Failed to find hashing algorithm");
}

2. 编译修改后的源码替换项目依赖，从根本解决该问题。

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