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，并限定作用范围。推荐写法如下：

Pandas 配置文件报告生成器

使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。

下载

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

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

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

• 变量值中含 < 或 &：必须在 .properties 文件里写成 和 <code>&（即双重转义）
• 想让某个 ${...} 不被替换（比如 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>
    <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 在某些插件版本中会被截断）

Maven 对 XML 的变量过滤本质是「带条件的文本替换」，它不理解 XML 语义，也不校验格式是否合法。最容易被忽略的是：没加 <includes> 导致二进制资源损坏，以及变量值含未转义的 XML 特殊字符引发解析失败。上线前务必用 target/classes/ 下的实际输出文件验证替换结果。