如何避免Ansible community.general.xml模块转义HTML实体？

问题描述 #

我想用Ansible的community.general.xml模块修改XML文件，期望得到的<Connector>节点内容如下：

<Connector relaxedQueryChars="[]|{}^&#x5c;&#x60;&quot;&lt;&gt;"/>

我编写的Ansible任务代码如下：

- name: "Update relaxedQueryChars"
  community.general.xml:
    path: "/conf/server.xml"
    xpath: /Server/Service/Connector
    attribute: "relaxedQueryChars"
    value: "[]|{}^\`"<>"

但执行后，所有&都被自动转义成了&，最终得到的XML内容变成了：

<Connector relaxedQueryChars="[]|{}^&amp;#x5c;&amp;#x60;&amp;quot;&amp;lt;&amp;gt;"/>

我试过以下几种写法，都没能阻止转义：

value: '[]|{}^\`"<>'
value: "[]|{}^\\\`\"\<\>"
value: []|{}^\\\`\"\<\>

请问该如何阻止Ansible对HTML实体进行转义？

解决方案 #

方式1：启用raw参数强制写入原始字符串 #

community.general.xml模块默认会按照XML规范转义特殊字符，添加raw: yes参数可以让模块直接将传入的value作为原始字符串写入，跳过转义逻辑。修改后的任务代码如下：

- name: "Update relaxedQueryChars"
  community.general.xml:
    path: "/conf/server.xml"
    xpath: /Server/Service/Connector
    attribute: "relaxedQueryChars"
    value: "[]|{}^\`"<>"
    raw: yes

方式2：直接传入实体对应的原始字符 #

XML里的实体引用最终会被解析为对应的实际字符，你可以直接在value中写入这些字符本身，不需要用实体编码。比如：

• \ 对应反斜杠 \
• ` 对应反引号 `
• " 对应双引号 "
• < 对应小于号 <
• > 对应大于号 >

用单引号包裹value避免YAML解析时转义，修改后的代码如下：

- name: "Update relaxedQueryChars"
  community.general.xml:
    path: "/conf/server.xml"
    xpath: /Server/Service/Connector
    attribute: "relaxedQueryChars"
    value: '[]|{}^\`"<>'

这种方式更符合XML的标准使用逻辑，XML解析器会正常处理这些特殊字符。

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