本文详解如何正确处理 json 字符串中嵌套 json（即 json 内容以转义字符串形式存在）的反序列化难题，重点解决 jackson 因未正确转义导致的解析异常，并提供可落地的代码示例与最佳实践。
本文详解如何正确处理 json 字符串中嵌套 json（即 json 内容以转义字符串形式存在）的反序列化难题，重点解决 jackson 因未正确转义导致的解析异常，并提供可落地的代码示例与最佳实践。
在实际开发中，尤其是对接第三方服务或遗留系统时，常会遇到一种特殊结构的 JSON 响应：外层是标准 JSON 对象，但某个字段（如 errormessage）的值并非普通字符串，而是经过 JSON 序列化后的字符串——即“JSON in JSON”。这种嵌套结构若未经正确处理，Jackson 在反序列化时会将其误认为外层 JSON 的语法组成部分，从而抛出类似 Unexpected character ('t' (code 116)) 的解析异常。
根本原因在于：该字段值本身是一个合法的 JSON 对象，但被双引号包裹并作为字符串字面量嵌入外层 JSON 中。因此，在 Java 源码中定义该字符串字面量时，必须对内部 JSON 的所有双引号（"）和反斜杠（）进行双重转义——第一层由 JSON 规范要求（字符串内引号需写为 "），第二层由 Java 字符串字面量语法规则要求（" 需写作 \"，而 需写作 \）。
以下为正确构造嵌套 JSON 字符串字面量的示例：
final String nestedErrorResponse =
"{"errormessage":"{\"timestamp\":\"2021-10-19T07:57:35.205+0000\",\"status\":400,\"error\":\"Bad Request\",\"message\":\"Bad Request: xxxx xx is xx xxx. path=/xxx/verify\",\"path\":\"/xxx/xxx\"}"}";✅ 关键点：内部 JSON 的每个 " 必须写作 \"，确保最终传入 Jackson 的字符串中，errormessage 字段值为一个完整的、未损坏的 JSON 字符串（如 "{"timestamp":"..."}）。
完成字符串构造后，使用 Jackson 反序列化即可正常工作：
ObjectMapper objectMapper = new ObjectMapper();
objectMapper.registerModule(new Jdk8Module()); // 支持 Optional
TransferResponse response = objectMapper.readValue(nestedErrorResponse, TransferResponse.class);
// 此时 response.getMessage().orElse("") 将返回原始嵌套 JSON 字符串若后续还需进一步解析 errormessage 中的嵌套 JSON（例如提取 timestamp 或 status），可对其内容再次调用 objectMapper.readValue(...)，例如：
String innerJson = response.getMessage().orElse("");
if (!innerJson.isEmpty()) {
JsonNode innerNode = objectMapper.readTree(innerJson);
String timestamp = innerNode.path("timestamp").asText();
int status = innerNode.path("status").asInt();
}⚠️ 注意事项与最佳实践：
- 避免手动拼接嵌套 JSON 字符串：极易出错。推荐通过 objectMapper.writeValueAsString() 动态生成内层 JSON，再整体构建外层结构；
- IDE 辅助：IntelliJ IDEA 等现代 IDE 在粘贴 JSON 到字符串中时，会自动完成转义（右键 → Paste as JSON 或启用自动转义选项），大幅提升准确性；
-
字段设计考量：若业务中频繁出现此类嵌套结构，建议将 errormessage 类型定义为 String（而非 Optional
），并在文档中明确其语义为“序列化后的错误详情对象”，提升接口可维护性； - 异常防御：在二次解析嵌套 JSON 前，务必校验字符串非空且为合法 JSON 格式，避免 JsonProcessingException 中断流程。
通过理解 JSON 与 Java 字符串双层转义机制，并辅以工具链支持，即可稳健应对嵌套 JSON 的反序列化挑战。
