Using non-native transports with SocketOptions should cause an error

src/main/java/io/lettuce/core/SocketOptions.java

@@ -19,6 +19,7 @@
  */
 package io.lettuce.core;
 
+import io.lettuce.core.resource.Transports;
 import java.time.Duration;
 import java.util.concurrent.TimeUnit;
 
@@ -228,7 +229,16 @@ public Builder tcpNoDelay(boolean tcpNoDelay) {
          * @return new instance of {@link SocketOptions}
          */
         public SocketOptions build() {
-            return new SocketOptions(this);
+            SocketOptions options = new SocketOptions(this);
+
+            boolean requiresNative = options.isKeepAlive() || options.isExtendedKeepAlive() || options.isEnableTcpUserTimeout();
+
+            if (requiresNative && !Transports.areNativeTransportsAvailable()) {
+                throw new IllegalStateException(
+                        "The configured SocketOptions (keepAlive or tcpUserTimeout) require native transports (io_uring, epoll, kqueue), which are not available.");
+            }
+
+            return options;
         }
 
     }

src/main/java/io/lettuce/core/resource/Transports.java

@@ -42,6 +42,15 @@ public static Class<? extends Channel> socketChannelClass() {
         return NioSocketChannel.class;
     }
 
+    /**
+     * Checks if native transports (io_uring, epoll, kqueue) are available.
+     *
+     * @return {@code true} if native transports are available, {@code false} otherwise.
+     */
+    public static boolean areNativeTransportsAvailable() {
+        return NativeTransports.isAvailable();
+    }
+
     /**
      * @return the default {@link DatagramChannel} for socket (network/UDP) transport.
      */