如何在 Java 中正确获取和处理 HTTP 响应状态码
本文详解如何使用 java 原生 `httpurlconnection` 获取服务器返回的 http 状态码（如 200、404、500），并安全处理成功与错误响应，避免 `ioexception` 误判，同时提供现代替代方案建议。
在 Java 中，获取 HTTP 响应状态码的核心在于：URLConnection 的子类 HttpURLConnection 提供了 getResponseCode() 方法，但前提是必须先触发请求（如调用 getInputStream() 或 getErrorStream()）。你当前代码中直接使用 url.openConnection() 返回的是通用 URLConnection，未强制转为 HttpURLConnection，因此无法访问 HTTP 特有方法。
✅ 正确实现：使用 HttpURLConnection 获取状态码
以下是修正后的完整示例（基于你原有逻辑重构）：
import java.io.*;
import java.net.*;
public class HttpExample {
public static void connection(int portNumber, String addr, String request)
throws IOException {
URL url = new URL(addr);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
// 配置请求
conn.setRequestMethod("POST");
conn.setDoOutput(true);
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
conn.setConnectTimeout(5000);
conn.setReadTimeout(5000);
// 发送请求体
try (DataOutputStream dos = new DataOutputStream(conn.getOutputStream())) {
dos.writeBytes(request);
}
// ? 关键步骤：获取响应码（必须在读取响应前调用）
int responseCode = conn.getResponseCode();
System.out.println("HTTP Response Code: " + responseCode);
// 根据状态码决定读取哪个流
InputStream inputStream;
if (responseCode >= 200 && responseCode < 300) {
// 成功响应 → 读取 getInputStream()
inputStream = conn.getInputStream();
} else {
// 错误响应（如 404、500）→ 读取 getErrorStream()（若存在）
inputStream = conn.getErrorStream() != null ?
conn.getErrorStream() :
new ByteArrayInputStream(new byte[0]);
}
// 统一读取响应内容
try (BufferedReader reader = new BufferedR
eader(
new InputStreamReader(inputStream, StandardCharsets.UTF_8))) {
String line;
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
}
}
}
eader(
new InputStreamReader(inputStream, StandardCharsets.UTF_8))) {
String line;
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
}
}
}⚠️ 重要注意事项
- 类型转换不可少：url.openConnection() 返回 URLConnection，必须显式强转为 HttpURLConnection 才能调用 getResponseCode()。
- 响应码获取时机：getResponseCode() 会隐式触发请求（类似“懒加载”），但不能在 getInputStream() 抛出异常后才调用——否则可能因连接已关闭而失败。
- 错误流处理：HTTP 错误状态（4xx/5xx）下，getInputStream() 会抛出 IOException，此时应改用 getErrorStream() 读取服务端返回的错误详情（如 JSON 错误信息）。
- 超时设置：务必设置 setConnectTimeout() 和 setReadTimeout()，防止请求无限阻塞。
- 资源管理：使用 try-with-resources 自动关闭流，避免内存泄漏。
? 更推荐的现代实践（生产环境）
虽然原生 HttpURLConnection 可用，但其 API 冗长、易出错，且不支持连接池、自动重试、响应体反序列化等高级特性。强烈建议在新项目中使用成熟第三方客户端：
| 客户端 | 特点 | 快速上手示例 |
|---|---|---|
| OkHttp（推荐） | 轻量、高性能、默认连接池、简洁 API | java OkHttpClient client = new OkHttpClient(); Request req = new Request.Builder().url(addr).post(RequestBody.create(request, MediaType.get("text/plain"))).build(); Response res = client.newCall(req).execute(); System.out.println(res.code()); |
| Apache HttpClient | 功能全面、企业级稳定、文档丰富 | 需引入 httpclient 依赖，使用 CloseableHttpClient |
? 提示：Maven 引入 OkHttp： com.squareup.okhttp3 okhttp 4.12.0
总结
掌握 HttpURLConnection.getResponseCode() 是理解 Java HTTP 通信的基础。但请记住：它只是起点，而非终点。对于实际开发，优先选用 OkHttp 或 Apache HttpClient——它们将底层复杂性封装为直观、健壮、可维护的接口。而当你需要深入原理（如自研 SDK、教学演示或受限环境），本文提供的原生实现便是可靠、清晰的参考范本。
