使用Liberty Maven插件Dev模式部署时server.xml配置失效排查

核心问题根源 #

在mvn liberty:dev开发模式下，liberty-maven-plugin会自动部署当前项目的应用（基于artifactId生成上下文根），这会和你在server.xml中手动配置的<application>节点产生冲突：插件自动部署的应用会覆盖server.xml的配置，同时因为dev模式下可能未生成完整的demo.war包，还会触发"找不到应用"的警告，最终导致你的自定义上下文根和类加载器配置完全失效。

分步解决方案 #

1. 禁用插件自动部署，让server.xml配置生效

修改pom.xml中的liberty-maven-plugin配置，添加<deploy>false</deploy>禁用自动部署，确保server.xml的应用配置被使用：

<plugin>
    <groupId>io.openliberty.tools</groupId>
    <artifactId>liberty-maven-plugin</artifactId>
    <version>3.9</version>
    <configuration>
        <copyDependencies>
            <!-- 保留你原有的依赖拷贝配置 -->
        </copyDependencies>
        <!-- 禁用插件自动部署，使用server.xml的应用配置 -->
        <deploy>false</deploy>
        <!-- 可选：配置应用工件，确保dev模式热部署功能正常 -->
        <appArtifact>
            <groupId>${project.groupId}</groupId>
            <artifactId>${project.artifactId}</artifactId>
            <version>${project.version}</version>
            <type>war</type>
        </appArtifact>
    </configuration>
</plugin>

2. 修正server.xml的应用路径配置

dev模式下项目可能未打包成war文件，将<application>的location改为使用Maven变量指向编译后的输出，避免"找不到demo.war"的警告：

<application location="${project.build.directory}/${project.build.finalName}.war" type="war" context-root="/ctx">
    <classloader apiTypeVisibility="+third-party" />    
</application>

3. 验证效果

重新执行mvn liberty:dev：

• 上下文根http://localhost:9080/ctx可正常访问，不再出现"Context Root Not Found"错误
• Maven终端的CWWKZ0013E和CWWKZ0014W错误/警告消失
• EclipseLink的DescriptorCustomizer ClassCastException问题解决：类加载器配置生效后，应用能正确访问第三方API，类加载一致性得到保证

额外说明 #

如果需要保留dev模式的热部署特性（修改代码后自动刷新应用），配置<appArtifact>可以让插件监控项目变化并同步更新部署，同时依然遵循server.xml中的自定义配置。

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