当前位置：首页 > 文章列表 > 文章 > java教程 > Java获取和处理HTTP状态码方法

Java获取和处理HTTP状态码方法

2026-01-09 17:39:44 0浏览收藏

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战，手把手教大家学习《Java 如何获取和处理 HTTP 状态码》，在实现功能的过程中也带大家重新温习相关知识点，温故而知新，回头看看说不定又有不一样的感悟！

如何在 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 BufferedReader(
                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：

<dependency>
  <groupId>com.squareup.okhttp3</groupId>
  <artifactId>okhttp</artifactId>
  <version>4.12.0</version>
</dependency>

总结

掌握 HttpURLConnection.getResponseCode() 是理解 Java HTTP 通信的基础。但请记住：它只是起点，而非终点。对于实际开发，优先选用 OkHttp 或 Apache HttpClient——它们将底层复杂性封装为直观、健壮、可维护的接口。而当你需要深入原理（如自研 SDK、教学演示或受限环境），本文提供的原生实现便是可靠、清晰的参考范本。

本篇关于《Java获取和处理HTTP状态码方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！