MuleSoft中DB Payload转JSON时字段值为数组的问题排查

以下是针对该问题的具体排查和解决步骤：

• 检查数据来源与DataType配置

  • 先确认数据库查询是否确实只返回单行数据：如果是多行查询，结果自然是数组结构，需调整SQL语句（比如用主键查询、LIMIT 1限制行数）。
  • 核对RAML和DataType配置：确保字段类型定义为单个值（比如string、integer），而非数组类型（string[]、integer[]）。同时检查示例文件里的字段值是否为单个值，避免示例本身误导转换逻辑。

• 修正DataWeave转换逻辑
  数据库连接器返回的结果默认是数组格式（哪怕只有一行数据），转换时需要先提取单行数据再映射：

  %dw 2.0
  output application/json
  ---
  // 直接取第一个元素，字段名完全匹配时用这个
  payload[0]
  
  // 需要自定义字段映射时用下面的写法
  // payload[0] {
  //   userId: $.id,
  //   userName: $.name
  // }
  

• 调整数据库连接器输出设置
  在Mule 4及以上版本中，打开数据库组件的「Output」标签页，将「Output Type」设置为Single Object，这样连接器会直接返回单行对象而非数组，无需在DataWeave里额外处理。

• 验证排查
  在转换步骤前添加Logger组件，输出payload的原始结构，确认数据库返回的是单行数组还是多行数据，定位问题根源。

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