Improve SSL reload clarity: document trade-offs, use Path API, deduplicate PEM path logic

common/coap-server/src/main/java/org/thingsboard/server/coapserver/DefaultCoapServerService.java

@@ -154,6 +154,7 @@ public class DefaultCoapServerService implements CoapServerService, SmartInitial
         return networkConfig;
     }
 
+    // Note: this method has a side effect — it sets COAP_SECURE_PORT on the provided networkConfig.
     private DtlsConnectorConfig buildDtlsConnectorConfig(Configuration networkConfig) throws UnknownHostException {
         TbCoapDtlsSettings dtlsSettings = coapServerContext.getDtlsSettings();
         DtlsConnectorConfig dtlsConnectorConfig = dtlsSettings.dtlsConnectorConfig(networkConfig);
@@ -195,7 +196,9 @@ public class DefaultCoapServerService implements CoapServerService, SmartInitial
         DTLSConnector newConnector = createDtlsConnector(dtlsConnectorConfig);
         CoapEndpoint newEndpoint = buildDtlsEndpoint(networkConfig, newConnector);
 
-        // Stop the old endpoint first to release the port before starting the new one
+        // Californium binds the DTLS port at connector construction time, so we must stop the old
+        // endpoint first to release the port. This creates a brief window where the port is unbound;
+        // if the new endpoint fails to start, we attempt to restore the old one (see rollback below).
         if (oldDtlsEndpoint != null) {
             log.info("Stopping old DTLS endpoint to release the port...");
             server.getEndpoints().remove(oldDtlsEndpoint);

common/transport/transport-api/src/main/java/org/thingsboard/server/common/transport/config/ssl/KeystoreSslCredentials.java

@@ -20,9 +20,9 @@ import lombok.EqualsAndHashCode;
 import org.thingsboard.server.common.data.ResourceUtils;
 import org.thingsboard.server.common.data.StringUtils;
 
-import java.io.File;
 import java.io.IOException;
 import java.io.InputStream;
+import java.nio.file.Files;
 import java.nio.file.Path;
 import java.security.GeneralSecurityException;
 import java.security.KeyStore;
@@ -62,9 +62,9 @@ public class KeystoreSslCredentials extends AbstractSslCredentials {
     @Override
     public List<Path> getCertificateFilePaths() {
         if (!StringUtils.isEmpty(storeFile) && !storeFile.startsWith(ResourceUtils.CLASSPATH_URL_PREFIX)) {
-            File storeFileObj = new File(storeFile);
+            Path resolved = Path.of(storeFile).toAbsolutePath();
-            if (storeFileObj.exists()) {
+            if (Files.exists(resolved)) {
-                return Collections.singletonList(storeFileObj.toPath().toAbsolutePath());
+                return Collections.singletonList(resolved);
             }
         }
         return Collections.emptyList();

common/transport/transport-api/src/main/java/org/thingsboard/server/common/transport/config/ssl/PemSslCredentials.java

@@ -30,10 +30,10 @@ import org.bouncycastle.openssl.jcajce.JcePEMDecryptorProviderBuilder;
 import org.thingsboard.server.common.data.ResourceUtils;
 import org.thingsboard.server.common.data.StringUtils;
 
-import java.io.File;
 import java.io.IOException;
 import java.io.InputStream;
 import java.io.InputStreamReader;
+import java.nio.file.Files;
 import java.nio.file.Path;
 import java.security.GeneralSecurityException;
 import java.security.KeyStore;
@@ -145,22 +145,18 @@ public class PemSslCredentials extends AbstractSslCredentials {
     @Override
     public List<Path> getCertificateFilePaths() {
         List<Path> paths = new ArrayList<>();
+        addIfFileSystemPath(paths, certFile);
+        addIfFileSystemPath(paths, keyFile);
+        return paths;
+    }
 
-        if (!StringUtils.isEmpty(certFile) && !certFile.startsWith(ResourceUtils.CLASSPATH_URL_PREFIX)) {
+    private static void addIfFileSystemPath(List<Path> paths, String filePath) {
-            File certFileObj = new File(certFile);
+        if (!StringUtils.isEmpty(filePath) && !filePath.startsWith(ResourceUtils.CLASSPATH_URL_PREFIX)) {
-            if (certFileObj.exists()) {
+            Path resolved = Path.of(filePath).toAbsolutePath();
-                paths.add(certFileObj.toPath().toAbsolutePath());
+            if (Files.exists(resolved)) {
-            }
+                paths.add(resolved);
-        }
-
-        if (!StringUtils.isEmpty(keyFile) && !keyFile.startsWith(ResourceUtils.CLASSPATH_URL_PREFIX)) {
-            File keyFileObj = new File(keyFile);
-            if (keyFileObj.exists()) {
-                paths.add(keyFileObj.toPath().toAbsolutePath());
             }
         }
-
-        return paths;
     }
 
 }

common/transport/transport-api/src/main/java/org/thingsboard/server/common/transport/service/CertificateReloadManager.java

@@ -247,6 +247,8 @@ public class CertificateReloadManager implements SmartInitializingSingleton, Dis
             } catch (Exception e) {
                 consecutiveFailures++;
                 failedCombinedChecksum = combinedChecksum;
+                // Deliberately NOT updating the lastModifiedMap here, so the next poll cycle retries
+                // (mtime mismatch passes the early gate, checksum matches failedCombinedChecksum).
                 log.error("Failed to reload certificate for {} (attempt {}/{}): {}",
                         name, consecutiveFailures, MAX_CONSECUTIVE_FAILURES, e.getMessage(), e);
             }