在使用java的`java.net`包进行http请求时，当遇到400及以上错误状态码时，直接使用`getinputstream()`将无法获取到响应体。本教程将详细介绍如何通过判断`connection.getresponsecode()`并结合使用`connection.geterrorstream()`来正确读取这些错误响应的详细内容，确保即使在请求失败的情况下也能完整获取服务器返回的信息，从而有效诊断问题。
理解HttpURLConnection与错误响应
在Java标准库中，java.net包提供了进行HTTP通信的基础能力。开发者常利用HttpURLConnection类来发送HTTP请求并处理响应。然而，许多开发者在处理非成功状态码（如4xx客户端错误或5xx服务器错误）时，可能会遇到一个常见问题：无法获取到这些错误响应的详细内容。
当HTTP请求返回的状态码为2xx（成功）时，我们可以通过connection.getInputStream()方法轻松地读取服务器返回的响应体。但当状态码为400（Bad Request）、404（Not Found）或500（Internal Server Error）等错误码时，getInputStream()方法将不再返回有效的输入流，甚至可能抛出IOException。这是因为HttpURLConnection内部设计上，将非成功响应的详细信息视为“错误流”，需要通过专门的方法来访问。
解决方案：使用 getErrorStream()
为了正确获取HTTP错误响应的详细信息，HttpURLConnection提供了getErrorStream()方法。当connection.getResponseCode()返回的状态码是400或更高时，我们应该使用connection.getErrorStream()来读取响应体，而不是connection.getInputStream()。
核心逻辑如下：
立即学习“Java免费学习笔记（深入）”；
- 首先，通过connection.getResponseCode()获取HTTP响应状态码。
- 如果状态码大于等于400（即HttpURLConnection.HTTP_BAD_REQUEST），则说明是错误响应，应调用connection.getErrorStream()来获取输入流。
- 否则，如果状态码是2xx或3xx，则调用connection.getInputStream()来获取输入流。
代码示例
以下是一个修改后的sendPostRequest方法，它集成了上述逻辑，能够正确处理成功和错误响应的响应体。
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStreamWriter;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.util.Map;
// 假设这里有一个日志记录器，例如使用SLF4J
// import org.slf4j.Logger;
// import org.slf4j.LoggerFactory;
public class HttpConnectionHandler {
// private static final Logger log = LoggerFactory.getLogger(HttpConnectionHandler.class);
/**
* 发送HTTP POST请求并获取响应体，包括错误响应的响应体。
*
* @param requestUrl 请求的URL
* @param payload 请求体内容
* @param requestProperties 请求头属性
* @return 服务器返回的响应体字符串
*/
public static String sendPostRequest(String requestUrl, String payload, Map<String, String> requestProperties) {
StringBuilder responseBody = new StringBuilder();
HttpURLConnection connection = null;
try {
URL url = new URL(requestUrl);
connection = (HttpURLConnection) url.openConnection();
// 配置连接
connection.setDoInput(true);
connection.setDoOutput(true);
connection.setRequestMethod("POST");
connection.setConnectTimeout(5000); // 设置连接超时时间，单位毫秒
connection.setReadTimeout(5000); // 设置读取超时时间，单位毫秒
// 设置请求头属性
if (requestProperties != null) {
for (Map.Entry<String, String> entry : requestProperties.entrySet()) {
connection.setRequestProperty(entry.getKey(), entry.getValue());
}
}
// 默认设置Content-Type为application/json，如果payload是JSON格式
if (!requestProperties.containsKey("Content-Type")) {
connection.setRequestProperty("Content-Type", "application/json");
}
// 写入请求体
try (OutputStreamWriter writer = new OutputStreamWriter(connection.getOutputStream(), StandardCharsets.UTF_8)) {
writer.write(payload);
writer.flush(); // 确保所有数据都已写入输出流
}
// 获取响应状态码
int responseCode = connection.getResponseCode();
// log.info("请求URL: {}, 响应状态码: {}", requestUrl, responseCode); // 记录响应码
InputStream inputStream;
// 根据响应码选择正确的输入流
if (responseCode >= HttpURLConnection.HTTP_BAD_REQUEST) { // 400及以上为错误响应
inputStream = connection.getErrorStream();
// log.warn("检测到错误响应，状态码: {}, URL: {}", responseCode, requestUrl);
} else {
inputStream = connection.getInputStream();
}
// 读取响应体
if (inputStream != null) { // 确保流不为空
try (BufferedReader br = new BufferedReader(new InputStreamReader(inputStream, StandardCharsets.UTF_8))) {
String line;
while ((line = br.readLine()) != null) {
responseBody.append(line);
}
}
} else {
// 极少数情况下，如果既没有正常输入流也没有错误流，可能发生
// log.warn("无法获取到URL: {} 的输入流，状态码: {}", requestUrl, responseCode);
}
} catch (Exception e) {
// log.error("HTTP请求到 {} 发生错误: {}", requestUrl, e.getMessage(), e);
System.err.println("HTTP请求到 " + requestUrl + " 发生错误: " + e.getMessage());
// 可以在这里选择抛出自定义异常，或者返回一个特定的错误指示符
} finally {
if (connection != null) {
connection.disconnect(); // 关闭HTTP连接
}
}
return responseBody.toString();
}
}注意事项
- 资源管理： 在上述代码中，使用了Java 7引入的try-with-resources语句来自动关闭OutputStreamWriter和BufferedReader，这是一种推荐的做法。对于HttpURLConnection本身，应在finally块中调用connection.disconnect()来确保连接被关闭，释放资源。
- 超时设置： connection.setConnectTimeout()和connection.setReadTimeout()是防止请求无限期阻塞的关键。setConnectTimeout设置建立连接的超时时间，setReadTimeout设置从连接读取数据时的超时时间。合理设置这些值可以提高应用程序的健壮性。
- 异常处理： HttpURLConnection在网络问题或协议错误时会抛出IOException。在实际应用中，应捕获这些异常，并进行适当的日志记录或错误处理，例如封装为业务异常。
- 字符编码： 在读取和写入数据时，始终指定字符编码（如StandardCharsets.UTF_8），以避免乱码问题。
- 请求头： 对于POST请求，Content-Type请求头通常是必需的，它告知服务器请求体的数据格式。根据实际情况设置，例如application/json或application/x-www-form-urlencoded。
- 日志记录： 详细记录请求URL、响应状态码、完整的请求体和响应体对于调试和监控至关重要。
总结
通过在java.net.HttpURLConnection中判断HTTP响应状态码，并根据情况选择使用getInputStream()或getErrorStream()，开发者可以确保无论是成功响应还是错误响应，都能完整地获取到服务器返回的响应体。这对于调试和构建健壮的客户端应用程序至关重要，因为它允许我们获取服务器在错误情况下提供的详细诊断信息。
虽然java.net包提供了基础的HTTP通信能力，但在复杂的生产环境中，考虑使用更专业的HTTP客户端库（如Apache HttpClient、OkHttp或Spring WebClient）可能会带来更高的开发效率和更强大的功能，它们通常提供更简洁、功能更丰富的API来处理各种HTTP场景，包括错误处理、连接池管理、重试机制等。然而，理解java.net包的底层工作原理，特别是错误流的处理机制，对于深入理解HTTP通信和排查问题仍然非常有价值。
