在DataWeave中显式生成XML属性需用@前缀声明字段(如@id: "123"),动态属性名须用[("key")]语法,空属性需用条件展开过滤,且属性与同名子元素不可共存。

如何在DataWeave中显式生成XML属性
DataWeave默认把对象字段渲染为XML子元素,**要生成属性(attribute),必须用 @ 前缀声明**。这是最常被忽略的语法门槛——没加 @,再怎么写字段名都不会变成属性。
例如,想让 ,必须写成:
%dw 2.0
%output application/xml
---
person: {
@id: "123"
}注意:@id 是固定写法,不能写成 @"id" 或 @'id';值可以是字符串、变量或表达式,但不能是对象或数组(否则会报错)。
-
@只作用于当前层级的直接字段,不支持嵌套路径(如@address.city无效) - 多个属性并列时,直接平铺写,比如
{@id: "123", @type: "user"} - 属性名若含连字符(如
xml:lang),需用双引号包裹:@'xml:lang': "en"
如何动态生成XML属性名(带命名空间或计算名)
当属性名本身来自变量或需拼接时,必须用方括号 [] + 字符串插值,@ 不能直接跟变量名。
比如,输入 payload 中有 payload.attrName = "status" 和 payload.attrValue = "active",要生成 :
%dw 2.0
%output application/xml
---
item: {
[(payload.attrName)]: payload.attrValue
}关键点:[(payload.attrName)] 是动态键语法,等价于 JavaScript 的 computed property;@ 仅用于静态属性名,不可用于此场景。
- 命名空间属性如
xmlns:xsi:写成@'xmlns:xsi': "http://www.w3.org/2001/XMLSchema-instance" - 空属性(如
required="")可直接赋空字符串:@required: "" - 若属性名含非法标识符字符(空格、冒号、点),必须用单引号或双引号包裹键名
如何避免属性与子元素混淆(常见错误根源)
一个字段既带 @ 又带普通键名,DataWeave 会报错;更隐蔽的问题是:**同名属性和子元素共存时,后者会被忽略且无提示**。
错误示例(看似合理,实则只保留属性,id 子元素消失):
person: {
@id: "123",
id: "duplicate" // ← 这行不会出现在输出中
}正确做法:严格区分用途。属性存元数据(ID、type、lang),内容存子元素(name, email)。
- 检查输出时用
%output application/xml indent=true确保可读性,避免“看不见的丢失” - 用
write(payload, "application/xml")在日志中打印中间结果,验证属性是否真被写入 - 如果源是XML且含属性,读取时也需用
@访问,例如payload.person.@id
处理带默认值或条件属性(跳过空属性)
和跳过空标签同理,**空属性(@id: null 或 @id: "")仍会输出为 id="",这不是你想要的**。必须显式过滤。
推荐写法:用条件展开(() 括号语法)+ when 判断值存在且非空:
%dw 2.0
%output application/xml
---
person: {
( @id: payload.id ) when payload.id != null and payload.id != "",
name: payload.name
}说明:() 表示可选片段,内部表达式只在 when 为 true 时参与构建;比 if-else 更轻量,适合长结构中局部控制。
- 别用
default处理属性——@id: payload.id default null不起作用 - 对数字型属性(如
@version: 2),注意null和0区分,判断时用payload.version? and payload.version != 0要谨慎 - CSV转XML时,若某列为空,对应属性应整体跳过,而不是留空字符串
属性不是“附加装饰”,而是XML语义的一部分;DataWeave里它和子元素走的是两套解析/生成逻辑,混用就掉坑里。最稳妥的做法:先画出目标XML结构,再逐个字段决定用 @ 还是裸键名,最后用条件展开兜底空值。










