Java 中正确处理 HTTP 400 错误响应的完整教程-java教程-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 = 200 && responseCode <p><strong>关键改进点说明：</strong>  </p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill6235" title="Java Maven Code Review"><img
														src="https://img.php.cn/upload/skill/000/000/081/179084711841712.jpg" alt="Java Maven Code Review" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill6235" title="Java Maven Code Review" class="overflowclass">Java Maven Code Review</a>
													<p class="overflowclass">审查Java Maven项目（ZIP压缩包或GitLab仓库URL），检查代码规范、命名、模块边界、可维护性问题以及重复代码。</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill6235" title="Java Maven Code Review" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>

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

调用示例与错误解析：

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);
}

注意事项：