Wildfly 9部署Web应用连接Infinispan 13.0.1集群出现ClosedChannelException错误

根因分析 #

报错底层抛出java.nio.channels.ClosedChannelException，本质是HotRod客户端无法和Infinispan服务端建立有效连接，连接建立过程中被直接断开，常见触发原因如下：

• 网络连通性阻断：Wildfly服务器和Infinispan集群之间的11222、11322端口被防火墙、安全组拦截，无法正常通信
• Infinispan服务端配置错误：HotRod端点仅绑定了127.0.0.1环回地址，不允许外部服务器访问，或对应端口未正常启动监听
• 客户端认证配置缺失：仅配置了用户名密码，未启用认证开关、指定认证域等必填参数，认证失败后服务端主动断开连接
• 客户端与服务端版本不兼容：Wildfly 9自带的Infinispan客户端版本较低，和Infinispan集群的版本不匹配，导致握手失败连接被关闭
• 配置文件加载失败：代码中异常捕获仅打印了自定义提示，未输出完整异常栈，若配置文件路径错误、权限不足导致加载失败，客户端会用默认配置尝试连接本地11222端口，必然连接失败

解决步骤 #

1. 验证网络连通性
   在部署Wildfly的服务器上执行以下命令，确认端口可达：

nc -zv 155.10.6.87 11222
nc -zv 155.10.6.87 11322

若端口不可达，先开通对应网络访问策略。
2. 检查Infinispan服务端配置
确认HotRod端点绑定地址为0.0.0.0或对应可访问的公网/内网IP，服务运行正常，11222、11322端口处于监听状态。
3. 补全客户端配置
在hotrod-client.properties中增加以下必填认证配置：

infinispan.client.hotrod.use_auth=true
infinispan.client.hotrod.auth_realm=default
infinispan.client.hotrod.sasl_mechanism=DIGEST-MD5

4. 对齐客户端与服务端版本
   确认项目引入的infinispan-client-hotrod依赖大版本和Infinispan服务端版本一致，若Wildfly自带的客户端版本不匹配，在jboss-deployment-structure.xml中排除Wildfly自带的Infinispan相关模块，使用项目打包的对应版本依赖。
5. 优化异常捕获逻辑
   修改代码中的异常捕获块，输出完整异常信息，避免配置加载失败后用默认配置运行：

catch (Exception ex) {
    System.err.println("Error loading infinispan hotrod-client.properties file");
    ex.printStackTrace();
    throw new RuntimeException("Failed to load hotrod client config", ex);
}

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