BufferedReader 本身不支持超时控制，必须通过 Socket.setSoTimeout() 设置底层 socket 超时；其 read() 等方法阻塞依赖 SocketInputStream 的 native 调用，超时仅在 socket 层生效，且需在获取 InputStream 前设置，否则无效。
BufferedReader 本身不支持超时控制，它只是对底层 InputStream 的装饰器，真正的读取超时必须由 Socket 层设置 —— 也就是通过 Socket.setSoTimeout() 来生效。
为什么 BufferedReader 没有 timeout 参数
BufferedReader 的 read()、readLine() 等方法会阻塞，直到数据到达或流关闭。它内部调用的是 InputStreamReader → InputStream → SocketInputStream，而超时逻辑只在 SocketInputStream 的底层 native 方法中触发。所以无论你给 BufferedReader 加多少层包装，只要没在 Socket 上设 soTimeout，它就可能无限等待。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
正确配置读取超时的步骤
- 先创建 Socket（或通过 URLConnection 获取底层 Socket）
- 在调用 getInputStream() 之前，调用 socket.setSoTimeout(5000)（单位毫秒）
- 再构建 BufferedReader：
new BufferedReader(new InputStreamReader(socket.getInputStream())) - 后续 readLine() 或 read() 就会在 5 秒无数据时抛出 SocketTimeoutException，而非一直卡住
常见误区与避坑点
- HttpClient（如 Apache HttpComponents）里的 setSocketTimeout 是作用于底层 Socket 的 soTimeout，不是 BufferedReader 的属性
- 不要试图用 Timer 或 Future.cancel 中断 BufferedReader —— 它无法真正中断底层 socket read 调用，可能留下资源泄漏
- 如果使用 URLConnection，需在 openConnection() 后 cast 成 HttpURLConnection，再调用 setReadTimeout()（等价于 setSoTimeout）
- soTimeout 只影响单次 read 操作；若 readLine() 跨多个 TCP 包，超时从每次底层 read 开始重新计时，不是整行读取总耗时
一个最小可验证示例
以下代码能稳定触发 Read timed out：
Socket socket = new Socket("example.com", 80);
socket.setSoTimeout(2000); // ⚠️ 关键：必须在获取流前设置
BufferedReader reader = new BufferedReader(
new InputStreamReader(socket.getInputStream(), StandardCharsets.UTF_8)
);
// 发送简单 HTTP 请求头后不响应，2秒后抛出 SocketTimeoutException
PrintWriter writer = new PrintWriter(socket.getOutputStream(), true);
writer.println("GET / HTTP/1.0");
writer.println("Host: example.com");
writer.println();
try {
String line = reader.readLine(); // 此处将超时
} catch (SocketTimeoutException e) {
System.err.println("读取超时：" + e.getMessage());
}
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
