Zeebe Java环境下正确存储JSON类型流程变量的方法

你看到带转义符的存储结果，是因为提前将DTO序列化为JSON字符串后再传入Zeebe客户端，客户端会将传入的字符串值做二次JSON序列化，最终存储的就是带转义的字符串类型值，而非原生JSON结构。Zeebe本身原生支持结构化JSON变量存储，不需要提前手动将对象转为JSON字符串传入。

• 方案1：直接传入DTO实例（推荐）
  Zeebe Java/Kotlin客户端内置了Jackson序列化适配，直接将DTO对象作为变量值传入即可，客户端会自动将对象序列化为原生JSON结构存储，不会产生转义。
  错误写法示例：

  // 不推荐：提前转成JSON字符串，会触发二次序列化
  String dtoJson = objectMapper.writeValueAsString(dto);
  Map<String, Object> vars = Map.of("data", dtoJson);
  

  正确Java写法：

  YourDto dto = new YourDto("10");
  Map<String, Object> variables = Map.of("data", dto);
  zeebeClient.newCreateInstanceCommand()
    .bpmnProcessId("your-process-key")
    .latestVersion()
    .variables(variables)
    .send()
    .join();
  

  正确Kotlin写法：

  data class ProcessDto(val id: String)
  val dto = ProcessDto(id = "10")
  zeebeClient.newCreateInstanceCommand()
    .bpmnProcessId("your-process-key")
    .latestVersion()
    .variables(mapOf("data" to dto))
    .send()
    .join()
  

• 方案2：自定义序列化场景传入JsonNode
  如果你需要自定义序列化逻辑、不方便直接传DTO实例，不要调用writeValueAsString获取字符串，而是将DTO转为Jackson的JsonNode对象传入，客户端会识别该类型直接作为结构化JSON存储，不会二次转义：

  JsonNode dtoNode = objectMapper.valueToTree(dto);
  Map<String, Object> variables = Map.of("data", dtoNode);
  // 正常传入variables即可
  

如果自定义了Zeebe客户端的ObjectMapper配置，不要开启将非基础类型强制序列化为字符串的规则，默认配置下直接传入POJO、Map、JsonNode类型的变量值，都会被正确序列化为无转义的原生JSON结构，在Operate中查看的结果为标准的{"id":"10"}格式。

校验技巧：可以开启Zeebe客户端的debug日志查看发往网关的请求体，只要变量对应字段的值是JSON对象而非被引号包裹的字符串，就不会出现转义问题。

内容的提问来源于stack exchange，提问作者Alexander