更换Puppet file资源source文件名后XML文件误报内容变更咨询

我们运行Puppet v7.20版本，使用file资源定义向多台主机部署XML文件，配置如下：

file { "${extract_dir}/solr-${version}/server/etc/jetty.xml":
    ensure => file,
    source => 'puppet:///modules/profile/solr/jetty_<version>.xml',
    owner  => 'solr',
    group  => 'solr',
  }

当修改source参数指定的文件名后，下一次Puppet Agent运行时报告该文件内容发生变更，但实际检查新旧文件内容并无差异。

请问这是否是Puppet的已知问题/行为？我推测这可能是因为XML文件需规范化后才能准确比对导致，但Puppet在生成目录时是否应处理该问题？

以下是puppetserver.log中的相关日志条目：

2025-08-19T12:36:06.160Z INFO  [qtp206662768-242054] [puppetserver] //<hostname>//Stage[main]/Profile::Solr::Install_8_11/File[/opt/solr-8.11.1/server/etc/jetty.xml]/content content changed '{sha256}6830607ff44b3c5bb36d931e8ae9ce4fd2bf743414283ec0979394d2a23a6832' to '{sha256}8b3960ff8cab8d0500677529e9ffcf78d91bb24463f46cf40cd64e8c18369f97'

• 这是Puppet的预期行为，并非已知bug。Puppet的file资源默认通过文件原始字节流的哈希值（此处为SHA256）判断是否需要更新，不会对XML内容做规范化处理（比如忽略换行符差异、缩进变化、注释位置调整等）。
• 你遇到的情况，本质是新旧两个source文件逻辑内容一致，但字节层面存在差异——比如换行符格式（CRLF与LF）、多余空格/制表符、XML标签缩进不同，这些差异肉眼难以察觉，但会导致哈希值完全不同，因此Puppet判定内容发生变更并重新部署。
• Puppet作为通用配置管理工具，不会自动处理XML规范化。如果需要基于XML的逻辑内容而非原始字节比对，可通过以下方式解决：
  • 预处理模块中的XML文件：用xmllint等工具对所有source XML做统一格式化，确保字节结构完全一致
  • 自定义Puppet函数：在部署前对目标文件和source文件做规范化后再比对，但会增加配置复杂度
• 另外，即使新旧source文件逻辑内容完全一致，只要文件名变更后对应的文件哈希值不同，Puppet就会触发变更报告，这是由其基于字节哈希的比对逻辑决定的。

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