本文详解如何在 Jackson 中正确反序列化包含转义 JSON 字符串（即“JSON-in-JSON”）的嵌套结构，重点解决因字符串未正确转义导致的 Unexpected character 解析异常。
本文详解如何在 jackson 中正确反序列化包含转义 json 字符串（即“json-in-json”）的嵌套结构，重点解决因字符串未正确转义导致的 `unexpected character` 解析异常。
在实际 API 交互中，有时后端会将完整的错误响应体作为字符串字段（如 "errormessage"）嵌入外层 JSON 中——这本质上是「JSON 中嵌套了已序列化的 JSON 字符串」。此时若直接用 Jackson 反序列化，而未对内层 JSON 字符串做双重转义处理，就会触发类似以下的解析异常：
Unexpected character ('t' (code 116)): was expecting comma to separate Object entries
at [Source: (String)"{"errormessage":"{"timestamp":...}"}"; line: 1, column: 21]根本原因在于：Java 字符串字面量中的 JSON 内容本身含有双引号（"）、反斜杠（）等特殊字符，必须在 Java 层进行转义，才能让 Jackson 在解析时将其识别为一个纯字符串值，而非试图解析为嵌套 JSON 对象。
✅ 正确做法是：对内层 JSON 字符串中的所有双引号和反斜杠，在 Java 字符串中做双重转义。例如原始内层 JSON：
{"timestamp":"2021-10-19T07:57:35.205+0000","status":400,"error":"Bad Request"}在 Java 字符串字面量中应写作：
"{"timestamp":"2021-10-19T07:57:35.205+0000","status":400,"error":"Bad Request"}"注意：每个 " → "，而 （如时间戳中的 u003d）需写成 u003d；若原始 JSON 已含转义（如 pathu003d/xxx/verify），则 Java 中须为 pathu003d/xxx/verify。
以下是完整可运行示例：
import com.fasterxml.jackson.annotation.JsonAlias;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jdk8.Jdk8Module;
import java.util.Optional;
public class TransferResponse {
private Optional<String> timeStamp = Optional.empty();
private Optional<String> status = Optional.empty();
private Optional<String> error = Optional.empty();
@JsonAlias({"errorMessage", "errormessage"})
private Optional<String> message = Optional.empty(); // ← 接收整个嵌套 JSON 字符串
private Optional<String> path = Optional.empty();
// getters/setters (omitted for brevity)
}
// 使用示例
public class Main {
public static void main(String[] args) throws Exception {
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new Jdk8Module());
// ✅ 正确：内层 JSON 字符串已做 Java 层双重转义
final String nestedErrorResponse =
"{"errormessage":"{\"timestamp\":\"2021-10-19T07:57:35.205+0000\",\"status\":400,\"error\":\"Bad Request\",\"message\":\"Bad Request: xxxx xxx. path\\u003d/xxx/verify\",\"path\":\"/xxx/xxx\"}"}";
TransferResponse response = mapper.readValue(nestedErrorResponse, TransferResponse.class);
System.out.println("Raw errormessage: " + response.getMessage().orElse("null"));
// 输出：{"timestamp":"2021-10-19T07:57:35.205+0000","status":400,"error":"Bad Request",...}
}
}⚠️ 注意事项：
- 若需进一步解析 errormessage 中的嵌套 JSON，可对其 message.get() 结果再次调用 mapper.readValue(..., InnerError.class)；
- IDE（如 IntelliJ）粘贴 JSON 到字符串中时，通常自动补全转义（右键 → Paste as JSON 或启用 Auto-escape string literals），可大幅降低手动出错概率；
- 避免拼接 JSON 字符串 —— 应优先使用 ObjectMapper.writeValueAsString() 生成合法 JSON 字符串，再嵌入外层结构；
- @JsonAlias 仅影响字段名映射，不改变字符串内容解析逻辑，此处仅用于兼容 errormessage / errorMessage 两种命名。
总结：处理「JSON-in-JSON」的关键不是修改反序列化逻辑，而是确保输入字符串在 Java 层已符合语法规范——即把内层 JSON 当作普通字符串看待，并严格转义其特殊字符。这是 Jackson 正常工作的前提，也是跨系统数据交换中常见但易被忽视的底层细节。
