ACE中XML映射本质是XSLT 3.0，Mapping Editor仅为图形化封装，导出为标准.xsl文件；需严格匹配命名空间、慎用受限XSLT函数，并分三层调试。
ACE 中的 XML 映射本质是 XSLT 3.0，不是图形化拖拽
IBM App Connect Enterprise（ACE）里所谓“XML 映射”，底层实际调用的是 xslt3 引擎，不是独立映射语言，也不是可视化连线逻辑。你看到的 Mapping Editor 界面只是 XSLT 的图形封装，导出后仍是标准 .xsl 文件。这意味着：写复杂逻辑时，图形界面很快会失效，必须切到源码编辑模式；调试时看到的错误基本都是 XSLT 报错，比如 XSLT0012 或 FOAY0001，而不是 ACE 特有异常。
常见误区是以为拖几个字段就能完成嵌套循环或条件聚合——实际上，这类操作需手动补全 <xsl:for-each>、<xsl:if> 或 <xsl:variable>，图形界面只生成最简骨架。
输入/输出 Schema 必须显式绑定，且命名空间要严格匹配
ACE 不会自动推断 XML 命名空间（namespace）。如果输入 XML 带有 xmlns="http://example.com/ns"，而你在 Mapping Editor 中没在 Input Schema 属性里填入对应 URI，XSLT 就查不到任何节点，结果为空。输出同理——漏设 Output Schema 的 Target namespace，会导致生成的 XML 没有 xmlns 声明，下游系统可能直接拒收。
- 输入 Schema 的
Namespace字段必须和实际 XML 的xmlns值完全一致（包括末尾斜杠、大小写） - 输出 Schema 的
Target namespace若为空，生成的根元素不会带xmlns，即使你在 XSLT 里写了exclude-result-prefixes也无效 - 多命名空间混用时，必须在 Schema 中定义 prefix（如
ns1），并在 XSLT 中用xmlns:ns1="..."显式声明
常用但易错的 XSLT 函数在 ACE 中受限或行为不同
ACE 内置的 Saxon-HE 引擎（XSLT 3.0）不支持全部函数。例如：fn:json-to-xml() 和 fn:xml-to-json() 在 ACE v12.0.9 及之前版本不可用；fn:parse-xml() 要求输入是 well-formed 字符串，若含未转义的 & 或 < 会直接报 FODC0002 错误；fn:format-number() 的 pattern 语法和 Java DecimalFormat 不兼容，"#,##0.00" 会失败，得写成 "#,##0.00"（看似一样，但 ACE 对引号内空格敏感）。
实操建议：
- 避免用
fn:current-dateTime()直接拼字符串，ACE 时区默认是 UTC，业务时间需显式加adjust-dateTime-to-timezone(., xs:dayTimeDuration('PT8H')) - 字符串截取别用
substring-before($str, '&')，先用replace($str, '&', '&')预处理，否则解析器提前报错 - 数组映射慎用
for $i in 1 to count($nodes)，改用for $n in $nodes更稳，ACE 对 position() 支持不稳定
调试 XML 映射必须分三层看日志
单靠 Mapping Editor 的“Test”按钮看不出真实问题。真正有效的调试路径是：
- 第一层：在
mqsireportproperties中启用trace=true，捕获节点级输入/输出 XML，确认原始数据是否已损坏（比如 CDATA 被提前解析） - 第二层：在
server.conf.yaml中设置logging: {xslt: DEBUG}，查看 Saxon 实际执行的 XSLT 源码和变量值（注意：日志里$var显示为Q{http://saxon.sf.net/}var） - 第三层：把生成的
.xsl拷到本地用 Saxon-HE 命令行验证，命令为saxon -s:input.xml -xsl:map.xsl -o:output.xml
，可快速复现并隔离 ACE 运行时干扰
最容易被忽略的是：ACE 在 Windows 和 Linux 上对换行符（
vs
）的处理不一致，同一份 XSLT 在开发环境跑通，上线后因平台差异导致文本节点内容错位。
