Java 中使用 HttpURLConnection 发起请求时，当服务器返回 4xx 或 5xx 状态码（如 400），getInputStream() 会抛出 IOException；此时应改用 getErrorStream() 获取错误响应体，从而读取服务端返回的 JSON、文本等诊断信息。
java 中使用 httpurlconnection 发起请求时，当服务器返回 4xx 或 5xx 状态码（如 400），`getinputstream()` 会抛出 ioexception；此时应改用 `geterrorstream()` 获取错误响应体，从而读取服务端返回的 json、文本等诊断信息。
在 Java 标准库中，HttpURLConnection 对成功响应（HTTP 状态码 200–299）和错误响应（如 400、404、500 等）采用了分离式流管理机制：
- ✅ getInputStream()：仅在响应状态码为成功范围时可用，否则抛出 IOException；
- ✅ getErrorStream()：专为错误响应设计，当 getResponseCode() >= 400 时返回非 null 的 InputStream（若服务端确实返回了响应体），可用于读取错误详情（例如 Spring Boot 返回的 { "timestamp": "...", "status": 400, "error": "Bad Request", "message": "id cannot be empty" }）。
以下是修正后的完整示例代码，支持统一处理成功与失败响应：
package com.test123;
import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.util.Base64;
public class Main009 {
public static void main(String[] args) throws Exception {
String username = "xxx";
String password = "yyy";
URL url = new URL("http://host/path");
HttpURLConnection http = (HttpURLConnection) url.openConnection();
http.setRequestMethod("POST");
http.setDoOutput(true);
http.setDoInput(true);
http.setConnectTimeout(5000);
http.setReadTimeout(5000);
byte[] request = "{ \"id\": \"test2\" }".getBytes(StandardCharsets.UTF_8); // 注意：JSON key 应加双引号
http.setFixedLengthStreamingMode(request.length);
String auth = "Basic " + Base64.getEncoder()
.encodeToString((username + ":" + password).getBytes(StandardCharsets.UTF_8));
http.setRequestProperty("Authorization", auth);
http.setRequestProperty("Content-Type", "application/json; charset=UTF-8");
// 发送请求体
try (OutputStream os = http.getOutputStream()) {
os.write(request);
os.flush();
}
// 关键：根据响应码选择输入流
InputStream inputStream;
int responseCode = http.getResponseCode();
if (responseCode >= 200 && responseCode < 300) {
inputStream = http.getInputStream();
} else {
inputStream = http.getErrorStream(); // ✅ 400/500 等错误场景下必须使用此方法
}
// 统一读取响应体
if (inputStream != null) {
String responseBody = readAsString(inputStream, StandardCharsets.UTF_8);
System.out.println("Response (" + responseCode + "): " + responseBody);
} else {
System.out.println("Response (" + responseCode + "): no response body");
}
}
private static String readAsString(InputStream is, java.nio.charset.Charset charset) throws IOException {
try (Reader reader = new InputStreamReader(is, charset);
BufferedReader br = new BufferedReader(reader)) {
return br.lines().collect(java.util.stream.Collectors.joining("\n"));
}
}
}⚠️ 注意事项：
- getErrorStream() 仅在 getResponseCode() >= 400 时返回有效流；若服务端未返回响应体（如某些 Nginx 配置），该方法可能返回 null，务必判空；
- 不要调用 http.connect() 手动连接——getOutputStream() 或 getInputStream() 会隐式触发连接；
- 始终设置超时（setConnectTimeout / setReadTimeout），避免阻塞；
- JSON 请求体中字段名必须使用双引号（"{\"id\":\"test2\"}"），原始代码中的单引号语法无效；
- 生产环境建议迁移到更现代的 HTTP 客户端（如 HttpClient（Java 11+）、OkHttp 或 Retrofit），它们对错误响应体的处理更直观、健壮。
通过合理使用 getErrorStream()，你不仅能捕获 400 错误，还能解析服务端返回的结构化错误信息，大幅提升 API 调试与用户提示能力。
