Maven怎么过滤XML资源文件中的变量

resources插件默认不处理XML中的${...}变量，因其仅在显式启用filtering且通过includes限定XML文件时才执行纯文本替换，不解析XML结构，未定义变量亦不报错。

为什么 resources 插件默认不处理 XML 中的 ${...} 变量

Maven 的资源过滤（resource filtering）默认只对 src/main/resources 下的文件生效，但关键点在于：它**不会自动启用变量替换**，除非你显式开启 filtering，且该功能对 XML 文件本身没有特殊支持——它只是做字符串级别的文本替换。如果你的 application.xml 里写了 ${database.url}，但没配对，Maven 就原样拷贝过去，不会报错，也不会替换。

• 变量来源只能是 properties 文件（如 src/main/filters/dev.properties）、 块、或命令行 -D 参数
• XML 文件本身不是 Maven 的“配置文件”，它不解析 XML 结构，只当纯文本处理
• 如果变量未定义，Maven 默认保留原始占位符（如 ${missing.prop}），不会报错，容易漏检

如何在 pom.xml 中正确启用 XML 资源过滤

必须在 maven-resources-plugin 配置中显式设置 filtering = true，并限定作用范围。推荐写法如下：

  
    
      src/main/resources
      true
      
        **/*.xml
        **/*.properties
      
    
  

  
    
      org.apache.maven.plugins
      maven-resources-plugin
      3.3.1
      
        UTF-8
      
    
  

• 是必须的：否则 filtering=true 会作用于所有资源（包括二进制文件），导致损坏
• 不要用 排除非 XML 文件——优先级低、易遗漏；用 更安全
• 确保 maven-resources-plugin 版本 ≥ 3.2.0，旧版本对多层级路径（如 config/db/app.xml）可能过滤失败

怎么避免 XML 特殊字符和占位符冲突

XML 文件里既有 ${...} 占位符，又有 、& 等实体，若变量值含这些字符，直接插入会导致 XML 格式错误。Maven 不做转义，需手动处理：

• 变量值中含 或 &：必须在 .properties 文件里写成 zuojiankuohaophpcn 和 &（即双重转义）
• 想让某个 ${...} 不被替换（比如 MyBatis 的 ${param} 动态 SQL）：写成 $${param} —— Maven 会把两个 $ 解析为一个，保留原始 ${param}
• 使用 mvn resources:resources -X 查看调试日志，确认哪些文件被过滤、哪些变量被解析、哪些未定义

Profile 激活时变量没生效？检查 filter 文件路径和激活逻辑

常见现象：mvn clean package -Pdev 后 XML 里还是 ${db.host}，没变成 localhost。问题往往出在 filter 文件未加载或 profile 未真正激活：

• filter 文件路径必须匹配 配置，例如：

  
    src/main/filters/${env}.properties
  

  此时必须通过 -Denv=dev 或 profile 的 dev 传入 env
• profile 的 dev 必须与 -Pdev 完全一致，大小写敏感
• filter 文件里的 key 必须是纯 ASCII，不能含空格或点号（如 db.url 可以，db.url.v2 在某些插件版本中会被截断）