本文详解 java 中调用 teamtailor rest api 时因 json 格式不规范、异常处理缺失及 http 客户端配置不当导致的“请求成功但抛异常”问题，并提供可生产落地的修复方案。
本文详解 java 中调用 teamtailor rest api 时因 json 格式不规范、异常处理缺失及 http 客户端配置不当导致的“请求成功但抛异常”问题，并提供可生产落地的修复方案。
在集成 TeamTailor API（如创建候选人 POST /v1/candidates 和投递职位申请 POST /v1/job-applications）过程中，开发者常遇到一种看似矛盾的现象：API 实际已成功执行（如候选人被创建，HTTP 状态码为 201），但客户端代码却抛出异常，导致后续逻辑（如创建职位申请）无法继续执行。典型报错如 Must use either different key or iv for GCM encryption，表面指向加密层，实则多为底层 HTTP 库（如 Unirest 或 OkHttp）对响应解析失败所触发的误报——根本原因往往藏于 JSON 构建与响应校验环节。
? 根本原因分析
从你提供的 createCandidateUniRest 方法可见，核心问题在于：
- 手动拼接 JSON 字符串：使用字符串拼接构造请求体（"\"first-name\": \"" + nome + "\"") 极易引入非法字符（如未转义的引号、换行、Unicode 控制符），导致生成的 JSON 不合法；
- 忽略 HTTP 状态码校验：Unirest 默认不会因非 2xx 状态码自动抛异常，但若响应体本身不是有效 JSON（如 TeamTailor 返回 HTML 错误页或空响应），new JSONObject(response.getBody()) 就会抛出 JSONException，进而被误判为网络或加密错误；
- 异常处理粗暴：catch (UnirestException e) { throw new RuntimeException(e); } 掩盖了真实上下文，且未区分连接异常、超时、业务错误等场景；
- 混合使用不同 HTTP 客户端：前段用 Unirest，后段用 OkHttp，配置不统一（如超时、SSL 设置），增加调试复杂度。
? 提示：Must use either different key or iv for GCM encryption 这类错误通常出现在 Android 环境下 OkHttp 的 TLS 层，但在纯 Java 后端中极少出现——它往往是 IOException 被错误包装后的“噪音”。请优先检查 JSON 合法性与 HTTP 状态码。
✅ 正确实践：结构化 JSON + 健壮响应处理
推荐使用 Jackson（或 Gson）替代字符串拼接，并严格校验响应状态。以下是重构后的 createCandidate 示例：
private String createCandidate(String firstName, String lastName, String email)
throws IOException, JSONException {
// 使用 Jackson 构建类型安全的请求体
ObjectMapper mapper = new ObjectMapper();
ObjectNode requestBody = mapper.createObjectNode();
ObjectNode data = requestBody.putObject("data");
data.put("type", "candidates");
ObjectNode attributes = data.putObject("attributes");
attributes.put("first-name", firstName);
attributes.put("last-name", lastName);
attributes.put("email", email);
// 执行请求（建议统一使用 OkHttp，避免 Unirest 的维护风险）
OkHttpClient client = new OkHttpClient.Builder()
.connectTimeout(30, TimeUnit.SECONDS)
.readTimeout(30, TimeUnit.SECONDS)
.build();
RequestBody body = RequestBody.create(
MediaType.parse("application/vnd.api+json"),
mapper.writeValueAsString(requestBody)
);
Request request = new Request.Builder()
.url("https://api.teamtailor.com/v1/candidates")
.post(body)
.addHeader("Authorization", "Token token=" + authToken)
.addHeader("X-Api-Version", "20210218")
.addHeader("Content-Type", "application/vnd.api+json")
.build();
try (Response response = client.newCall(request).execute()) {
if (!response.isSuccessful()) {
String errorBody = response.body() != null ? response.body().string() : "(empty)";
throw new IOException("TeamTailor API error: " + response.code()
+ " " + response.message() + ", body: " + errorBody);
}
String responseBody = response.body().string();
JsonNode jsonNode = mapper.readTree(responseBody);
return jsonNode.path("data").path("id").asText(); // 安全取值，避免 NPE
}
}? 后续职位申请（Job Application）的链式调用优化
在 createJobApplication 中，应确保：
- 候选人创建失败时明确抛出业务异常（如 CandidateCreationException），而非 RuntimeException；
- 使用同一套 JSON 序列化工具构建请求体，保持一致性；
- 显式处理 422 Unprocessable Entity 等常见业务错误（如 jobId 不存在、候选人邮箱重复）。
public Response createJobApplication(String firstName, String lastName, String email)
throws CandidateCreationException {
String candidateId;
try {
candidateId = createCandidate(firstName, lastName, email);
} catch (IOException | JSONException e) {
throw new CandidateCreationException("Failed to create candidate", e);
}
// 构建 job-application 请求体（同样使用 Jackson）
ObjectMapper mapper = new ObjectMapper();
ObjectNode requestBody = mapper.createObjectNode();
ObjectNode data = requestBody.putObject("data");
data.put("type", "job-applications");
ObjectNode relationships = data.putObject("relationships");
ObjectNode candidateRel = relationships.putObject("candidate");
candidateRel.put("type", "candidates").put("id", candidateId);
ObjectNode jobRel = relationships.putObject("job");
jobRel.put("type", "jobs").put("id", jobId); // 确保 jobId 已正确初始化
ObjectNode attributes = data.putObject("attributes");
attributes.put("cover-letter", "");
attributes.put("sourced", true);
attributes.put("send-user-notifications", true);
// 发送请求...
RequestBody body = RequestBody.create(
MediaType.parse("application/vnd.api+json"),
mapper.writeValueAsString(requestBody)
);
// ...（同上 OkHttp 构建与执行逻辑）
}⚠️ 关键注意事项
- 永远不要拼接 JSON：使用 Jackson/Gson 等库保证语法合法，自动处理转义、编码、嵌套；
- 必须校验 response.isSuccessful()：TeamTailor 对无效请求返回 400/422，对认证失败返回 401，忽略状态码将导致“成功假象”；
- 统一 HTTP 客户端栈：避免 Unirest（已归档）与 OkHttp 混用；OkHttp 支持连接池、拦截器、重试，更适合生产环境；
-
启用日志拦截器（开发期）：
client = new OkHttpClient.Builder() .addInterceptor(new HttpLoggingInterceptor().setLevel(BODY)) .build(); - 敏感字段脱敏：日志中勿打印 authToken、email 等，可用占位符替代。
✅ 总结
TeamTailor API 集成失败的“表象”（如 GCM 加密错误）多源于底层 JSON 构造缺陷与响应处理松散。通过结构化序列化 + 状态码强校验 + 统一 HTTP 客户端 + 语义化异常四步改造，即可彻底规避“请求成功却中断流程”的陷阱，构建高可靠的人才系统对接能力。记住：API 的契约始于 JSON 的合法性，止于你对每个字节的敬畏。
