FreeMarker传递XML节点作为宏参数的方法及取值报错解决方案

你遇到的报错，本质不是FreeMarker不支持把XML节点当宏参数传递——恰恰相反，FreeMarker的XML节点模型从设计上就支持将节点作为变量、参数在模板的任意流程中转递。报错来自两个容易被忽略的规则细节：

• FreeMarker访问XML同名子节点时，不管实际XML里该名称的节点有几个，返回值永远是NodeListModel（节点集合类型）。哪怕目标节点在XML里只出现了1次，框架也不会自动把结果降级成单个可输出的标量值，因此直接把inp.leaf放在${}里就会触发类型不匹配的报错。
• 被导入的模板和主模板是命名空间隔离的：你在Main.ftl里配置的ns_prefixes={"D":"urn:hl7-org:v3"}只对Main.ftl本身生效，support.ftl如果要访问同命名空间下的节点，必须自己重新声明相同的前缀映射，否则会因为命名空间不匹配，根本定位不到正确的子节点。

你现有的“传整个XML节点”的传参逻辑完全可以保留，不需要拆成零散的字符串参数，只需要调整support.ftl的内容即可，修正代码如下：

<#-- 必须和主模板保持完全一致的命名空间映射，解决跨模板的节点匹配问题 -->
<#ftl ns_prefixes={"D":"urn:hl7-org:v3"}>

<#macro support inp>
  <#-- 按带前缀的节点名匹配子节点，返回的是节点集合，取第0个元素获取单节点，加空值兜底避免节点缺失时报错 -->
  ${inp["D:leaf"][0]!''}
</#macro>

如果实际业务里的XML存在同名节点多次出现、部分节点可能缺失的情况，可以在宏内部增加兼容逻辑，避免硬写数组下标导致的运行错误：

<#ftl ns_prefixes={"D":"urn:hl7-org:v3"}>

<#macro support inp>
  <#-- 匹配目标子节点，自动兼容单节点、节点集合、节点缺失三类场景 -->
  <#local targetNode = inp["D:leaf"]>
  <#if targetNode?is_sequence>
    <#local targetNode = targetNode[0]>
  </#if>
  ${targetNode!''}
</#macro>

这种方式完全保留了XML节点的完整结构，在宏内部可以继续遍历任意层级的子节点、读取节点属性，不需要拆分大量零散的字符串参数，完全匹配你简化复杂XML模板维护的需求。

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