Spring Boot项目打包成WAR包，部署到宝兰德中间件踩坑全记录（附完整POM配置）
Spring Boot项目WAR包部署宝兰德中间件实战指南
1. 国产化迁移背景下的部署挑战
最近几年，国产中间件在金融、政务等关键领域逐步替代传统WebLogic、WebSphere等国外产品。宝兰德作为国产中间件的代表之一，其兼容性适配成为开发者必须掌握的技能点。不同于Tomcat这类轻量级容器，企业级中间件对应用部署有着更严格的规范要求。
Spring Boot默认内嵌Tomcat的设计理念与外部应用服务器部署存在天然冲突。当我们将一个开发阶段运行良好的Spring Boot应用打包成WAR部署到宝兰德时，往往会遇到各种"水土不服"的症状。典型表现包括：
- 类加载冲突（如ClassCastException）
- 依赖包版本不兼容
- 配置文件加载顺序异常
- 静态资源路径解析错误
这些问题的本质，是Spring Boot的"约定优于配置"哲学与企业级中间件的严格规范之间的碰撞。理解这个底层矛盾，是解决所有部署问题的钥匙。
2. 项目打包环节的陷阱规避
2.1 双打包插件冲突解析
执行mvn clean package后出现xxx.war和xxx.war.original两个文件，这是典型的插件冲突表现。其根本原因在于：
<!-- 问题复现的插件配置示例 --> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>3.1.0</version> </plugin> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> </plugins>两个插件的执行顺序与作用：
| 插件名称 | 执行阶段 | 产出文件 | 适用场景 |
|---|---|---|---|
| maven-war-plugin | package | xxx.war | 传统Java EE应用部署 |
| spring-boot-maven-plugin | package | xxx.war.original | 可执行JAR/WAR包部署 |
解决方案：对于需要部署到外部容器的场景，应当移除spring-boot-maven-plugin，保留标准的maven-war-plugin配置。
2.2 本地依赖打包配置
当项目依赖不在Maven中央仓库的JAR包（如达梦数据库驱动）时，需要特殊处理：
<plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <configuration> <webResources> <resource> <directory>lib/</directory> <targetPath>WEB-INF/lib</targetPath> <includes> <include>**/*.jar</include> </includes> </resource> </webResources> </configuration> </plugin>注意：lib目录应放在项目根目录下，与src目录同级
3. 容器冲突深度解析与解决方案
3.1 ClassCastException根源探究
报错WsServerContainer cannot be cast to org.apache.tomcat.websocket.server.WsServerContainer的直接原因是：
- Spring Boot默认打包会包含内嵌Tomcat
- 宝兰德中间件自带WebSocket实现
- 两个容器类加载器尝试加载同名类时发生冲突
依赖排除的正确姿势：
<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </exclusion> </exclusions> </dependency>3.2 常见兼容性问题清单
在宝兰德上部署时可能遇到的典型问题：
Servlet API版本冲突
- 现象：NoSuchMethodError或ClassNotFoundException
- 解决：统一使用中间件提供的servlet-api
JSP编译异常
- 现象：JSP文件无法编译或渲染错误
- 解决：检查中间件支持的JSP版本
静态资源404
- 现象：CSS/JS文件加载失败
- 解决：调整资源路径前缀匹配规则
4. 完整POM配置参考
以下是经过生产验证的完整配置方案：
<project> <!-- 基础配置省略 --> <dependencies> <!-- Web依赖（排除Tomcat） --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <exclusions> <exclusion> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-tomcat</artifactId> </exclusion> </exclusions> </dependency> <!-- 其他必要依赖 --> </dependencies> <build> <finalName>${project.artifactId}</finalName> <plugins> <!-- 核心打包插件 --> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <version>3.3.2</version> <configuration> <failOnMissingWebXml>false</failOnMissingWebXml> <webResources> <resource> <directory>lib/</directory> <targetPath>WEB-INF/lib</targetPath> <includes> <include>**/*.jar</include> </includes> </resource> </webResources> </configuration> </plugin> <!-- Spring Boot配置插件（非必须） --> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> <configuration> <classifier>exec</classifier> <skip>true</skip> </configuration> </plugin> </plugins> </build> </project>5. 部署后的调优建议
成功部署只是第一步，生产环境还需要注意：
JVM参数优化
- 宝兰德推荐的内存配置模式
- GC策略选择建议
类加载隔离
- 配置中间件的类加载策略
- 解决第三方库冲突的方案
监控集成
- 暴露Spring Boot Actuator端点
- 对接中间件管理控制台
在最近的一个政务云项目中，我们通过上述配置方案成功将Spring Boot应用部署到宝兰德集群，平稳运行超过6个月。关键点在于提前做好依赖树的梳理，避免容器功能重叠。