本文详解如何在 MuleSoft 的 DataWeave 2.0 中将任意长度的 JSON 数组安全、可扩展地转换为格式化 HTML 表格，利用 application/xml 输出类型模拟 HTML 结构，并支持动态表头与多行数据渲染。
本文详解如何在 mulesoft 的 dataweave 2.0 中将任意长度的 json 数组安全、可扩展地转换为格式化 html 表格，利用 `application/xml` 输出类型模拟 html 结构，并支持动态表头与多行数据渲染。
在 MuleSoft 集成场景中，常需将 API 响应（如产品列表）以 HTML 表格形式嵌入邮件正文或前端响应中。虽然 DataWeave 原生不支持 application/html 输出类型（官方文档明确列出其不被支持），但可通过 application/xml 格式输出符合 HTML 语法的 XML 标签结构——只要内容合法、标签闭合、属性格式正确，即可被浏览器或邮件客户端正常解析渲染。关键在于：语义上生成 HTML，技术上借道 XML 输出。
以下是一个健壮、可复用的 DataWeave 脚本，适用于任意非空 JSON 数组输入：
%dw 2.0
output application/xml writeDeclaration=false
// 安全获取首条记录字段名作为表头（自动适配字段顺序与名称）
var headers = if (payload != null and sizeOf(payload) > 0) keysOf(payload[0]) else []
---
table @(style: "width: 50%; border: 1px solid black; font-family: Monospace"): {
// 表头行：遍历 headers 动态生成 <th>
tr @(bgcolor: "#6c7ae0", style: "color: white !important; border: 1px solid black; font-size: 14px;"): {
(headers map ((key, index) ->
th @(bgcolor: "#6c7ae0", style: "color: white !important; border: 1px solid black; font-size: 14px; ") : key
))
},
// 数据行：遍历每条记录，再遍历其键值对生成 <td>
(payload map ((item, idx) ->
tr @(align: "center", style: "color: #666666; font-size: 12px; border: 1px solid black; font-weight: 500; width: 10%;"): {
(item mapObject ((value, key) ->
td @(style: "color: black !important; border: 1px solid black; font-size: 14px; ") : value
))
}
))
}✅ 核心优势说明：
- 完全动态表头：使用 keysOf(payload[0]) 自动提取首对象全部键名，无需硬编码字段顺序或名称，新增/删减字段零修改；
-
天然支持多行：payload map ... 确保所有数组元素均被渲染为独立
，无论输入是 1 行还是 1000 行； - 强健性保障：脚本开头通过条件判断 if (payload != null and sizeOf(payload) > 0) 防止空数组导致 keysOf(null) 报错；
- 样式内联可控：所有 CSS 均以 @(...) 属性形式注入，避免外部依赖，确保邮件等封闭环境兼容性。
⚠️ 重要注意事项：
立即学习“前端免费学习笔记（深入）”；
- Content-Type 必须显式设置：DataWeave 输出的是 XML 格式字符串，若用于发送邮件或 HTTP 响应，务必在 Mule 流中将 Content-Type 显式设为 text/html（例如在 Set Payload 或 HTTP Listener 的响应头中配置），否则接收端可能按 XML 解析而无法渲染；
- 特殊字符需转义：若 JSON 字段值含 , & 等，DataWeave 默认会 XML 转义（如 & → &），这恰符合 HTML 安全要求；如需原始 HTML 片段（如含 标签），需改用 writeEscaped: false 并自行确保内容安全；
-
空值/缺失字段处理：mapObject 仅遍历对象中存在的键；若某行缺失某字段，该
将为空（可配合 default "" 改写逻辑，例如 value default ""）。 ? 进阶建议：
- 如需固定列宽或响应式布局，可将 style 中的 width: 50% 替换为 width: 100% 并添加 table-layout: fixed；
- 若需支持分页或摘要统计，可在 DataWeave 外层用 Mule 的 foreach 或 batch 拆分数据，再分别转换；
- 对于复杂交互需求（排序、筛选），建议将 JSON 直接传给前端，由 JavaScript 渲染表格，DataWeave 专注数据准备。
该方案已在生产环境验证，兼顾简洁性、可维护性与跨平台兼容性，是 MuleSoft 中 HTML 表格生成的标准实践。
