Spring Boot整合东方通应用服务器常见问题

Question

**Spring Boot整合东方通应用服务器时，常见的部署兼容性问题有哪些？** 在使用Spring Boot整合东方通（TongWeb）应用服务器过程中，常遇到部署兼容性问题，如Servlet版本不兼容、依赖冲突、上下文路径配置不当等。由于TongWeb对部分标准Java EE规范实现方式不同，可能导致Spring Boot内嵌的Tomcat特有功能无法直接运行。此外，Spring Boot默认的打包方式为可执行jar，而TongWeb通常要求war包部署，需调整项目构建方式并排除内嵌容器依赖。如何正确配置web.xml、适配数据源及事务管理也是常见难点。解决这些问题需深入理解Spring Boot与TongWeb的协同机制，并进行针对性调优。

Answer 1

一、Spring Boot与东方通（TongWeb）整合的部署兼容性问题概述

随着国产中间件的发展，越来越多的企业开始将应用从传统Tomcat或Jetty迁移到国产中间件平台，如东方通TongWeb。Spring Boot作为主流的微服务框架，在与TongWeb集成过程中常遇到一系列部署兼容性问题。这些问题主要集中在容器适配、构建方式调整、依赖管理、Servlet规范支持及数据源配置等方面。

1. Servlet版本不兼容

• TongWeb默认支持的Servlet版本可能低于Spring Boot内嵌Tomcat的版本（例如TongWeb 7.x仅支持Servlet 3.0）。
• Spring Boot 2.x及以上版本通常需要Servlet 3.1+，这会导致部分注解驱动的功能无法正常运行。
• 解决方案：升级TongWeb版本至8.x以上，确保其支持Servlet 3.1及以上；若无法升级，则需手动替换Spring Boot中使用Servlet 3.1特性的代码逻辑。

2. 构建方式差异：Jar包 vs War包

Spring Boot默认以可执行jar形式打包，便于快速启动和内嵌容器运行，而TongWeb要求标准的war格式部署包。

1. 修改pom.xml中的打包方式为war：

2. <packaging>war</packaging>

3. 排除Spring Boot自带的Tomcat依赖：

4. <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-tomcat</artifactId>
       <scope>provided</scope>
   </dependency>

5. 配置主类继承SpringBootServletInitializer以支持外部容器加载。

3. web.xml缺失导致初始化失败

Spring Boot默认采用Java Config方式配置Servlet上下文，不生成web.xml文件。但某些TongWeb版本在部署时仍依赖web.xml进行初始化。

问题点	解决方法
缺少web.xml导致监听器未注册	添加src/main/webapp/WEB-INF/web.xml，并配置DispatcherServlet等组件
上下文路径配置不当	在web.xml中指定并设置

4. 数据源与事务管理适配问题

Spring Boot通常使用HikariCP或Tomcat JDBC作为连接池，而TongWeb推荐使用JNDI数据源。两者在事务管理机制上存在差异。

• 配置JNDI数据源示例：

• spring.datasource.jndi-name=java:comp/env/jdbc/myDataSource

• 在TongWeb的配置文件中定义JNDI名称，确保命名空间一致。
• 启用基于JTA的分布式事务管理器，避免本地事务冲突。

5. 依赖冲突与类加载问题

TongWeb自身的类加载机制可能导致Spring Boot依赖库被优先加载，从而引发NoClassDefFoundError或NoSuchMethodError。

graph TD A[Spring Boot项目] --> B{依赖是否冲突?} B -->|是| C[排除冲突依赖] B -->|否| D[继续部署] C --> E[使用Maven的exclusion标签或Gradle的exclude语句] E --> F[TongWeb部署测试]

6. 上下文路径与访问地址不一致

Spring Boot通过application.properties设置server.servlet.context-path，但在TongWeb中该配置可能失效。

• 解决方案1：在TongWeb的配置文件中显式指定应用上下文路径。
• 解决方案2：在web.xml中配置来设定应用根路径。

7. 异步请求处理异常

Spring Boot中常用的@Async异步调用在TongWeb中可能出现线程池未正确初始化的问题。

@EnableAsync
@Configuration
public class AsyncConfig implements AsyncConfigurerSupport {
    @Override
    public Executor getAsyncExecutor() {
        return Executors.newFixedThreadPool(5);
    }
}

建议显式配置线程池，避免TongWeb默认线程池不兼容Spring Boot异步机制。