java.net.ConnectException与org.apache.commons.httpclient.ConnectTimeoutException区别及模拟

1. java.net.ConnectException 与 org.apache.commons.httpclient.ConnectTimeoutException 的区别 #

• 触发场景差异

  • java.net.ConnectException：属于JDK底层IO异常，触发原因是TCP连接完全无法建立，比如目标服务器宕机、端口未开放、网络链路中断等，核心是连接建立失败，和时间无关。
  • org.apache.commons.httpclient.ConnectTimeoutException：是HttpClient 3框架封装的异常，特指在配置的连接超时时间内，未能成功完成TCP连接建立的情况。本质是连接超时导致的连接失败，明确了“超时”这个触发条件。

• 归属层级不同

  • java.net.ConnectException继承自java.io.IOException，是Java网络操作的通用异常，所有基于JDK网络API的操作都可能抛出。
  • org.apache.commons.httpclient.ConnectTimeoutException继承自org.apache.commons.httpclient.HttpException，是HttpClient 3自定义的框架级异常，仅在该客户端的连接阶段超时场景下抛出。

• 错误信息指向性不同

  • ConnectException的错误信息多为“Connection refused”（连接被拒绝）、“No route to host”（无路由到主机）等，直接说明连接失败的具体原因。
  • ConnectTimeoutException的信息会包含“Connect timed out”这类明确的超时描述，重点强调是因为超时导致连接未建立。

2. 本地模拟 org.apache.commons.httpclient.ConnectTimeoutException 的方法 #

方法1：短超时配置 + 屏蔽端口的目标地址 #

1. 把HttpClient的连接超时时间设为极短值（比如100ms）：

   HttpClient httpClient = new HttpClient();
   HttpConnectionManagerParams params = httpClient.getHttpConnectionManager().getParams();
   // 设置连接超时为100毫秒
   params.setConnectionTimeout(100);
   

2. 找一台正常运行的服务器，用防火墙屏蔽本机对其某个端口的访问（比如Linux用iptables -A OUTPUT -p tcp --dport 9999 -j DROP，Windows在防火墙里添加出站规则拒绝该端口）。
3. 发送请求到该服务器的屏蔽端口：HttpClient尝试建立连接，但端口被屏蔽导致无法在100ms内完成，就会抛出ConnectTimeoutException。

方法2：本地Mock延迟连接服务器 #

1. 编写一个简单的Socket服务器，接收到连接请求后故意延迟响应：

   public class DelayMockServer {
       public static void main(String[] args) throws IOException, InterruptedException {
           ServerSocket server = new ServerSocket(8888);
           while (true) {
               Socket socket = server.accept();
               // 延迟200毫秒再处理连接，确保超过HttpClient的超时配置
               Thread.sleep(200);
               socket.close();
           }
       }
   }
   

2. 配置HttpClient的连接超时为100ms（小于Mock服务器的延迟时间）。
3. 发送请求到localhost:8888：HttpClient在100ms内无法完成连接建立，会抛出ConnectTimeoutException。

测试注意事项 #

• 多线程测试时，要保证Mock场景的稳定性，避免线程竞争导致异常类型偏差。
• 测试完成后记得恢复防火墙规则或关闭Mock服务器，避免影响其他网络操作。

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