web.xml中Maven占位符不生效问题记录分析

问题背景

开发同学反馈了一个挺常见的坑：一个 Spring MVC 的 Web 项目，在 web.xml 里配置的占位符编译后纹丝不动，没被替换成预期的属性值。就像下面这样：

    logbackConfigLocation
    classpath:${loagback.xml.path:logback.xml}

看着挺眼熟吧？这问题其实不复杂，但背后牵涉到 Ma ven 的资源处理机制和不同插件之间的分工，值得捋一捋。

问题分析

先搞清楚一个基本逻辑：为什么在 Ma ven 项目里，${xx} 这种占位符能在编译期被替换成 properties 里的值？答案其实就一个插件——ma ven-resources-plugin。

这个插件干的事很明确：把资源文件从源目录复制到输出目录，同时还能干一件“顺带”的事——过滤掉 $ 占位符，从 Ma ven 的 Properties 里找到对应的变量并替换掉。

官方文档把它分成了三个目标，不过我们日常用的其实就两个核心功能：

• 复制或排除文件：决定哪些资源文件需要打包到目标目录
• 过滤占位符：把 ${...} 换成实际值

Ma ven 的“约定大于配置”在这里体现得挺明显——默认情况下，src/main/resources 就是它的“地盘”。只要资源文件放在这个目录下，哪怕 pom.xml 里一行配置都不写，插件也会自动管理，自动替换占位符。

问题定位

回到我们的场景：web.xml 的路径是 src/main/webapp/WEB-INF/，压根不在 src/main/resources 下，所以 ma ven-resources-plugin 默认对它视而不见，自然就不会替换占位符。

另外还有一个细节：${loagback.xml.path:logback.xml} 这种带默认值的写法，Ma ven 的占位符解析不像 Spring 那么智能——它不支持条件逻辑，老老实实写 ${loagback.xml.path} 就好，默认值得靠 properties 里定义清楚。

问题解决

对症下药，思路其实很清楚：

第一步： 把占位符改成不带默认值的写法 ${loagback.xml.path}，然后确保每个 profile 对应的 properties 里都配好了这个值。

第二步： 既然 web.xml 属于 webapp 目录下的资源，而项目里用的是 ma ven-war-plugin 打 war 包，这个插件自带对 webapp 资源的处理能力。只需要在 configuration 节点里加一个 webResources 配置，或者更简单点，把 filteringDeploymentDescriptors 设为 true 即可。

具体用法大家可以参考 ma ven-war-plugin 的官方文档，这里就不展开细说了。总之，搞清楚每个插件的职责边界，遇到这种“占位符不生效”的问题，思路就顺了。