通过Jolt Transform解决JSON/XML单元素数组序列化异常问题

问题根因 #

这类数组序列化错误是Jackson等Java XML/JSON映射库的常见默认行为：解析嵌套结构时，库会根据实际元素数量自动推断字段类型，当字段下只有1个元素时，不会将其识别为数组类型，直接序列化为单个对象，和多元素场景下的数组结构不一致，导致下游按固定数组结构解析时报错。
两种场景的结构对比如下：

• 多元素场景（结构正常）：

{
  "Car": {
    "data": [
      {
        "car": "Toyota"
      },
      {
        "car": "Maruti"
      }
    ]
  }
}

• 单元素场景（结构异常）：

{
  "Car": {
    "data": {
      "car": "Maruti"
    }
  }
}

修复方案 #

Jolt提供了两种配置方式，可以强制目标字段无论元素数量多少，始终输出为数组结构：

方案1：使用cardinality操作（推荐，配置最简） #

cardinality是Jolt专门用于调整字段集合类型的操作，指定字段为MANY类型后，会自动做类型适配：如果原字段是单个对象，就自动包装为单元素数组；如果原字段已经是数组，就保留原有数组结构不变，不需要写分支匹配规则。
完整Jolt配置如下：

[
  {
    "operation": "cardinality",
    "spec": {
      "Car": {
        "data": "MANY"
      }
    }
  }
]

方案2：使用shift操作自定义转换 #

如果需要在强制数组的同时调整字段映射规则，可以用shift操作分别匹配单对象、数组两种场景，手动组装数组结构：

[
  {
    "operation": "shift",
    "spec": {
      "Car": {
        "data": {
          // 匹配单对象场景，将对象放到数组第0位
          "car": "Car.data[0].car",
          // 匹配数组场景，按原索引遍历赋值所有元素
          "*": {
            "car": "Car.data[&1].car"
          }
        }
      }
    }
  }
]

转换效果 #

两种配置执行后，单元素异常输入会被转换为标准数组结构：

{
  "Car": {
    "data": [
      {
        "car": "Maruti"
      }
    ]
  }
}

多元素正常输入经过转换后结构完全不变，不会破坏原有正确数据。

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