Java 中正确处理 HTTP 400 错误响应的完整教程

阿杰君_6247

发布时间：2026-03-24 14:16:03

520人浏览过

来源于php中文网

原创

本文详解如何在 Java（特别是 Rhino 环境下）通过 HttpURLConnection 正确捕获并解析 REST API 返回的 HTTP 400（Bad Request）等客户端错误响应，避免因未读取 getErrorStream() 导致程序异常中断或丢失关键错误信息。

本文详解如何在 java（特别是 rhino 环境下）通过 `httpurlconnection` 正确捕获并解析 rest api 返回的 http 400（bad request）等客户端错误响应，避免因未读取 `geterrorstream()` 导致程序异常中断或丢失关键错误信息。

在调用 RESTful API（如 Okta 用户创建接口）时，服务端常通过非 2xx 状态码（如 400、401、409）反馈业务校验失败原因——例如重复邮箱、非法字段格式或组织内登录名冲突。然而，许多开发者在使用 java.net.HttpURLConnection 时仅关注 getInputStream()，却忽略了当响应状态码为 4xx/5xx 时，服务端错误体（error body）实际写入的是 getErrorStream()，而非 getInputStream()。若强行调用 getInputStream()，将直接抛出 java.io.IOException: Server returned HTTP response code: 400，导致错误详情（如 errorCode、errorCauses）完全丢失。

以下是一个修复后的健壮实现，适用于 Rhino（如 ServiceNow 或旧版脚本引擎）等受限 Java 环境：

function CreateUserInApp(rest_url, api_token, postJSON) {
    try {
        var postValBytes = new java.lang.String(postJSON).getBytes("UTF-8");
        var posturl = new java.net.URL(rest_url);
        var conn = posturl.openConnection();

        // 配置请求
        conn.setRequestMethod("POST");
        conn.setRequestProperty("Accept", "application/json");
        conn.setRequestProperty("Content-Type", "application/json");
        conn.setRequestProperty("Authorization", api_token);
        conn.setDoOutput(true);
        conn.setDoInput(true);
        conn.setConnectTimeout(10000);  // 建议添加超时控制
        conn.setReadTimeout(10000);

        // 发送请求体
        var outStream = conn.getOutputStream();
        outStream.write(postValBytes);
        outStream.flush();
        outStream.close();

        // 获取响应码
        var responseCode = conn.getResponseCode();

        // ✅ 关键修复：根据状态码选择输入流
        var inputStream;
        if (responseCode >= 200 && responseCode < 300) {
            inputStream = conn.getInputStream(); // 成功响应
        } else {
            inputStream = conn.getErrorStream(); // 错误响应（400/401/500等）
        }

        // 统一读取响应体
        var reader = new java.io.BufferedReader(
            new java.io.InputStreamReader(inputStream, "UTF-8")
        );
        var line;
        var responseBuilder = new java.lang.StringBuilder();
        while ((line = reader.readLine()) != null) {
            responseBuilder.append(line);
        }
        reader.close();
        inputStream.close(); // 显式关闭流，防止资源泄漏

        return {
            statusCode: responseCode,
            body: responseBuilder.toString(),
            success: (responseCode >= 200 && responseCode < 300)
        };

    } catch (e) {
        return {
            statusCode: null,
            body: "ERROR: " + e.toString(),
            success: false
        };
    }
}

关键改进点说明：

✅ 状态码驱动流选择：不再硬编码判断 "200" 字符串，而是用数值范围 (200–299) 判断成功，更符合 HTTP 规范；
✅ 显式关闭流：outStream.close() 和 inputStream.close() 防止连接池耗尽或内存泄漏；
✅ 统一编码读取：强制指定 "UTF-8" 编码，避免中文或特殊字符乱码；
✅ 结构化返回值：返回对象含 statusCode、body 和 success 标志，便于上层逻辑分支处理（如重试、日志记录、用户提示）；
✅ 超时防护：添加 setConnectTimeout/setReadTimeout，避免网络异常导致脚本长期挂起。

调用示例与错误解析：

Java Maven Code Review

审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。

下载

立即学习“Java免费学习笔记（深入）”；

var result = CreateUserInApp(
    "https://test-app.testlab.com/api/v1/users",
    "SSWS xxxxxxxxxxxxxxxxxxxxxxxx",
    JSON.stringify({
        "profile": {
            "firstName": "John1",
            "lastName": "Flow1",
            "email": "john1.flow1@test.com",
            "login": "john1.flow1@test.com",
            "mobilePhone": ""
        },
        "credentials": { "password": { "value": "P@ssw0rd123" } }
    })
);

if (!result.success) {
    print("API 调用失败，状态码：" + result.statusCode);
    try {
        var errorObj = JSON.parse(result.body);
        print("错误码：" + errorObj.errorCode);
        print("原因：" + errorObj.errorCauses[0].errorSummary);
        // 示例输出：login: An object with this field already exists...
    } catch (e) {
        print("无法解析错误响应：" + result.body);
    }
} else {
    print("用户创建成功：" + result.body);
}

注意事项：