为什么需要超时？

当你的 Java 程序执行以下操作时，如果没有设置超时，它会一直等待，直到操作完成或发生错误：

1. 连接 (Socket.connect())：尝试与服务器建立 TCP 连接。
2. 读取 (Socket.getInputStream().read())：从输入流中读取数据。
3. 写入 (Socket.getOutputStream().write())：向输出流中写入数据。

在不可靠的网络环境中,这些操作可能会因为各种原因而“卡住”，超时机制就是给这些操作设定一个最大等待时间，如果超过了这个时间还没有结果，程序就会抛出 SocketTimeoutException 异常，从而可以继续执行后续逻辑或进行重试，而不是永久挂起。

如何设置 Socket 超时？

Java 提供了两种主要的方式来设置 Socket 超时：

1. 设置单个操作的超时：这是最常用和最灵活的方式，可以为连接、读取、写入分别设置不同的超时。
2. 设置整个 Socket 的全局超时：这种方式比较简单，但不够灵活，且主要用于连接操作。

使用 Socket 类的方法 (推荐)

这是最标准和推荐的方法。java.net.Socket 类提供了三个核心方法来设置超时：

1. void connect(SocketAddress endpoint, int timeout)
2. void setSoTimeout(int timeout)
3. void setPerformancePreferences(int connectionTime, int latency, int bandwidth)

连接超时 (connect)

在尝试连接服务器时设置超时,单位是毫秒。

import java.io.IOException;
import java.net.InetSocketAddress;
import java.net.Socket;
import java.net.SocketTimeoutException;
public class ConnectTimeoutExample {
    public static void main(String[] args) {
        // 目标服务器的 IP 和端口
        String host = "www.example.com";
        int port = 80;
        // 设置连接超时时间为 3 秒 (3000 毫秒)
        int connectTimeout = 3000;
        try (Socket socket = new Socket()) {
            System.out.println("正在尝试连接到 " + host + ":" + port + "...");
            // 使用 connect 方法设置超时
            // InetSocketAddress 封装了 IP 地址和端口
            socket.connect(new InetSocketAddress(host, port), connectTimeout);
            System.out.println("连接成功!");
        } catch (SocketTimeoutException e) {
            // 如果连接超时，会抛出此异常
            System.err.println("连接超时: 在 " + connectTimeout + " 毫秒内未能连接到服务器。");
        } catch (IOException e) {
            // 其他 IO 异常，如服务器拒绝连接等
            System.err.println("连接发生错误: " + e.getMessage());
        }
    }
}

说明：

• connect(SocketAddress endpoint, int timeout) 是一个实例方法，它会在你指定的 timeout 时间内尝试建立连接。
• 如果超时,会抛出 java.net.SocketTimeoutException。
• 这个超时只对 connect 操作有效。

读取/接收超时 (setSoTimeout)

这是最常用的超时设置,用于控制从输入流中读取数据的超时时间，单位是毫秒。

这个超时对以下方法有效：

• InputStream.read()
• InputStream.read(byte[] b)
• InputStream.read(byte[] b, int off, int len)
• Socket.getInputStream().available() (在某些实现中)

重要提示：setSoTimeout 设置的是两次读取之间的最大空闲时间，而不是整个读取操作的总时间，如果你设置超时为 1000ms，

• 你调用 read()。
• 500ms 后，数据到达，read() 返回，这是正常的。
• 1500ms 后，数据才到达，在 read() 阻塞了 1000ms 后，它会抛出 SocketTimeoutException。

import java.io.*;
import java.net.*;
public class ReadTimeoutExample {
    public static void main(String[] args) {
        String host = "www.example.com";
        int port = 80;
        int readTimeout = 5000; // 5秒读取超时
        try (Socket socket = new Socket()) {
            // 1. 先建立连接 (可以设置连接超时)
            socket.connect(new InetSocketAddress(host, port), 3000);
            System.out.println("连接成功!");
            // 2. 设置读取超时
            socket.setSoTimeout(readTimeout);
            // 3. 发送一个简单的 HTTP 请求
            OutputStream out = socket.getOutputStream();
            PrintWriter writer = new PrintWriter(out, true);
            writer.println("GET / HTTP/1.1");
            writer.println("Host: " + host);
            writer.println("Connection: close");
            writer.println();
            // 4. 读取服务器响应
            InputStream in = socket.getInputStream();
            BufferedReader reader = new BufferedReader(new InputStreamReader(in));
            System.out.println("开始读取响应，超时时间: " + readTimeout + "ms...");
            String line;
            while ((line = reader.readLine()) != null) {
                // 只要能持续读到数据，就不会触发超时
                System.out.println(line);
            }
        } catch (SocketTimeoutException e) {
            System.err.println("读取超时: 在 " + readTimeout + " 毫秒内未收到任何数据。");
        } catch (IOException e) {
            System.err.println("IO 错误: " + e.getMessage());
        }
    }
}

写入超时

Java Socket 没有直接提供 setWriteTimeout() 这样的方法，写入操作的超时通常通过以下两种方式间接实现：

• 使用 setSoTimeout：在某些操作系统和 JVM 实现中，当发送缓冲区已满时，write() 操作会阻塞，等待网络缓冲区有空间，这种阻塞可能会受到 setSoTimeout 的影响，但这不是标准行为，不可靠。
• 结合 Socket.setSendBufferSize() 和 setSoTimeout：一个更可靠的模式是，在写入前检查发送缓冲区的状态，但这比较复杂。
• 最佳实践：对于大多数应用，如果写入操作可能长时间阻塞，通常意味着网络本身存在问题。setSoTimeout 可以作为一种兜底机制，防止整个线程因写入问题而挂起，更常见的做法是，如果写入逻辑复杂，应将其放在一个单独的线程中，并使用 interrupt() 机制来控制。

使用 java.net.SocketTimeoutException (已过时)

在早期 Java 版本中，有一个全局的 SocketTimeoutException 类，它有一个静态方法 setTimeout(int timeout)。这个方法在现代 Java 中已被废弃，不应该再使用。

// 错误且过时的方式
// SocketTimeoutException.setTimeout(5000); // 不要这样做！

最佳实践和注意事项

1. 总是使用 try-with-resources：像 Socket, InputStream, OutputStream 这样的资源应该放在 try-with-resources 语句中，以确保它们在使用后被正确关闭，防止资源泄露。

2. 区分连接超时和读取超时：

   • 连接超时：用于判断目标主机是否可达、端口是否开放，通常设置较短，如 2-5 秒。
   • 读取超时：用于判断网络是否活跃，如果服务器处理请求需要时间，这个值应该设置得比连接超时更长，对于一个可能需要 30 秒才能返回结果的 API，读取超时可以设置为 35 秒。

3. 处理 SocketTimeoutException：捕获这个异常后，你的程序应该知道操作失败了，可以根据业务需求决定是重试、记录日志还是直接放弃。

4. setSoTimeout 的影响范围：它只影响后续的读取操作，如果你在读取前修改了超时时间，它会立即生效。

5. SocketOptions：Socket 类还实现了 SocketOptions 接口，提供了其他有用的选项，可以通过 setOption() 方法设置：

   • SO_KEEPALIVE: 启用 TCP Keep-Alive 机制，可以检测到已经断开连接的对端。
   • SO_LINGER: 控制在调用 close() 方法时，如果还有数据未发送完毕，是否等待发送完成以及等待多久。
   • TCP_NODELAY: 禁用 Nagle 算法，对于需要低延迟的应用（如实时游戏、金融交易）很有用。

总结表格

掌握这些超时设置方法,是编写健壮、可靠的 Java 网络应用程序的基础。