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

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

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

Play.ht

根据文本生成多种逼真的语音

下载

<build>
  <resources>
    <resource>
      <directory>src/main/resources</directory>
      <filtering>true</filtering>
      <includes>
        <include>**/*.xml</include>
        <include>**/*.properties</include>
      </includes>
    </resource>
  </resources>

  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-resources-plugin</artifactId>
      <version>3.3.1</version>
      <configuration>
        <encoding>UTF-8</encoding>
      </configuration>
    </plugin>
  </plugins>
</build>

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

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

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

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

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

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

• filter 文件路径必须匹配 <filters></filters> 配置，例如：

  <filters>
    <filter>src/main/filters/${env}.properties</filter>
  </filters>

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