Ansible的community.general.xml模块不支持直接修改节点文本内容，仅能通过XPath定位增删节点或属性；修改文本需用replace正则、xmlstar命令或自定义Python脚本。
xml 模块不支持直接修改节点内容，只能增删节点或属性
Ansible 官方 xml 模块（community.general.xml）**不是 XML 编辑器**，它不提供类似 XPath 修改文本值、替换元素内容的能力。它的核心能力是：基于 XPath 定位，然后 添加新节点/属性 或 删除匹配的节点/属性。想“改配置值”，得绕道——比如先删再加，或用 lineinfile / replace 配合正则（不推荐用于嵌套结构），或换工具。
用 community.general.xml 添加或删除属性最稳妥
这是 xml 模块最稳定、最常用场景。比如给 <server></server> 元素加 port="8080"：
- name: Add port attribute to server element
community.general.xml:
path: /app/config.xml
xpath: /configuration/server
attribute: port
value: "8080"
state: present关键点：
-
xpath必须精准匹配到目标元素（如/configuration/server），不能匹配到多个节点，否则报错 -
state: present表示确保该属性存在；state: absent表示删除该属性 -
attribute是属性名，value是字符串值（即使数字也要加引号） - 模块会自动格式化缩进，但不会保留原有注释或空白行
修改节点文本内容？得用 replace + 正则，或切换成 xmlstar
比如要把 <maxconnections>100</maxconnections> 改成 200，xml 模块做不到。常见替代方案：
- 用
replace模块 + 简单正则（仅适用于无嵌套、无命名空间、标签格式固定的情况）：- name: Replace maxConnections value (fragile) replace: path: /app/config.xml regexp: '<maxConnections>[0-9]+</maxConnections>' replace: '<maxConnections>200</maxConnections>' - 更可靠的做法：用
xmlstar（需目标主机预装）+command模块：- name: Update maxConnections using xmlstar command: xmlstar --inplace -u "/configuration/maxConnections" -v "200" /app/config.xml args: executable: /bin/bash - 注意：
xmlstar不是 Ansible 内置模块，要确认目标节点已安装（可用package模块提前装）
常见失败原因：XPath 错误、命名空间、文件权限
运行时报 XPath evaluation failed 或 No nodes matched，八成是以下之一：
- XPath 路径写错，比如漏了根元素名，或大小写不一致（XML 区分大小写）
- XML 带命名空间（如
xmlns="http://example.com/ns"），而 XPath 没声明前缀——此时xml模块基本失效，必须换xmlstar或python lxml脚本 -
path指向的文件不存在，或 Ansible 执行用户（如root）无读写权限 - 文件被其他进程锁住（如 Java 应用正在读取 config.xml），导致写入失败
真正复杂的 XML 修改，别硬扛 xml 模块。写个几行 Python 脚本调 lxml，再用 script 模块执行，反而更可控、更易调试。
