1. 项目概述从Tomcat到东方通TongWeb的国产化迁移最近在做一个信创国产化适配的项目核心任务之一就是把SpringBoot应用默认内嵌的Tomcat服务器替换成国产的东方通TongWeb应用服务器。这活儿听起来好像就是换个依赖包改改配置但真干起来从环境准备、依赖冲突排查到部署调优每一步都可能藏着“坑”。很多团队在初次接触国产中间件时容易把问题想简单结果在部署阶段卡住影响项目进度。今天我就结合最近的实际迁移经验把从SpringBoot Tomcat切换到SpringBoot TongWeb的完整路径、核心原理和避坑要点梳理一遍目标是让你看完就能动手少走弯路。简单来说这个迁移的核心价值在于满足特定领域对软件基础设施国产化的要求。SpringBoot以其“约定大于配置”的便捷性著称其默认的Web容器是Tomcat。而东方通TongWeb作为一款成熟的国产Java应用服务器需要在SpringBoot框架下无缝替换Tomcat并保证应用功能、性能的稳定。这个过程不仅涉及依赖的变更更深层次的是对两类服务器在类加载机制、配置管理、会话处理等底层差异的兼容性适配。无论你是负责迁移的开发还是需要了解国产化技术的架构师掌握这套流程都至关重要。2. 迁移前的核心思路与准备工作2.1 理解替换的本质不仅仅是换个JAR包很多人以为替换Tomcat就是排除spring-boot-starter-tomcat然后引入TongWeb的客户端JAR包。这个操作没错但这只是表面。更深层的理解是我们是在替换SpringBoot内嵌的Servlet容器实现。SpringBoot通过spring-boot-starter-web默认引入了Tomcat。其自动装配机制会根据类路径下的容器类自动创建相应的ServletWebServerFactory。我们的目标就是让SpringBoot检测到TongWeb的相关类并转而使用TongWeb的工厂来创建Web服务器实例。因此准备工作必须细致。2.2 环境与依赖的精准准备首先你需要从东方通官方获取必要的资源。通常包括TongWeb应用服务器的安装包用于本地部署测试和了解其目录结构以及最重要的——TongWeb与SpringBoot集成的客户端JAR包。这个客户端JAR可能命名为tongweb-spring-boot-starter或类似的是关键它包含了TongWeb的ServletWebServerFactory实现以及相关的自动配置类。依赖调整示例Maven 在你的pom.xml中核心操作如下dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId !-- 关键排除默认的Tomcat -- exclusions exclusion groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-tomcat/artifactId /exclusion /exclusions /dependency !-- 引入TongWeb的SpringBoot Starter -- dependency groupIdcom.tongtech/groupId !-- 具体GroupId以官方为准 -- artifactIdtongweb-spring-boot-starter/artifactId version${tongweb.starter.version}/version /dependency注意tongweb-spring-boot-starter的版本需要与你的SpringBoot版本以及目标TongWeb服务器版本严格匹配。版本不匹配是启动失败最常见的原因之一务必查阅官方提供的兼容性矩阵。JDK版本确认检查你的项目JDK版本是否在TongWeb支持范围内。国产中间件对JDK版本可能比较敏感特别是从JDK 8升级到11或17时要留意模块化Module带来的变化。3. 核心配置解析与适配要点3.1 配置文件的关键调整迁移后原来针对Tomcat的server.tomcat.*配置项将不再生效。你需要将配置迁移到TongWeb的命名空间下。通常TongWeb Starter会定义类似server.tongweb.*的配置前缀。application.yml 配置示例对比# 原Tomcat配置部分失效 server: port: 8080 tomcat: max-threads: 200 uri-encoding: UTF-8 # 其他Tomcat特有配置... # 迁移后TongWeb配置示例具体属性名需参考官方文档 server: port: 8080 tongweb: max-threads: 200 min-spare-threads: 20 connection-timeout: 60000 uri-encoding: UTF-8 # 可能还有TongWeb特有的配置如工作目录、JSP支持开关等实操心得不要想当然地认为配置项名称只是简单地从tomcat换成tongweb。最可靠的方法是在引入Starter依赖后利用IDE的自动提示功能查看server.tongweb下有哪些可配置属性。或者直接查阅TongWeb官方提供的SpringBoot集成文档。3.2 处理JSP与静态资源的差异如果你的应用使用了JSP这里需要特别注意。Tomcat默认内置了Jasper引擎来处理JSP。而TongWeb可能使用不同的JSP实现或者需要显式开启支持。依赖检查确保项目中包含了JSP相关的依赖例如javax.servlet:jstl和org.apache.tomcat.embed:tomcat-embed-jasper注意这个依赖在TongWeb环境下可能仍需保留因为它是JSP编译引擎与容器无关但最好确认TongWeb Starter是否已包含或推荐特定版本。视图解析器配置在Spring MVC配置中检查InternalResourceViewResolver的前后缀设置是否正确指向你的JSP文件位置。静态资源路径Tomcat和TongWeb对静态资源如图片、CSS、JS的默认处理方式可能一致但如果你之前通过server.tomcat.basedir或webapp目录做了特殊配置需要找到TongWeb对应的配置项进行迁移。一个常见问题应用启动后访问JSP页面报错“JSP support is not available”或类似信息。这通常是因为TongWeb的JSP支持没有正确启用。解决方法除了检查依赖可能还需要在application.yml中明确配置server: tongweb: jsp: enabled: true # 如果TongWeb提供此配置4. 完整迁移与部署实操流程4.1 本地开发环境集成与测试依赖更新与编译完成pom.xml的修改后执行mvn clean compile确保没有依赖冲突。常见的冲突可能来自Servlet API、WebSocket等与容器紧密相关的包。使用mvn dependency:tree命令仔细检查。本地启动直接运行SpringBoot应用的Main类。如果集成正确控制台启动日志中应该看到TongWeb相关的标识而不是Tomcat。例如日志开头可能显示“Starting service [TongWeb]”或类似信息。基础功能测试启动后立即对核心功能进行冒烟测试访问首页或健康检查接口。测试关键业务API。如果有JSP页面访问验证渲染是否正确。测试文件上传下载、会话Session保持等功能。4.2 构建可部署的WAR包可选但重要虽然SpringBoot推荐打可执行JAR包并内嵌容器但在企业级生产环境中特别是使用TongWeb这类独立应用服务器时更常见的部署方式是打WAR包然后部署到外部的TongWeb服务器实例中。这种方式更利于运维统一管理、监控和集群部署。步骤修改打包方式在pom.xml中将packagingjar/packaging改为packagingwar/packaging。排除内嵌容器确保已经排除了spring-boot-starter-tomcat并且不引入TongWeb的Starter依赖因为容器由外部提供。取而代之的是需要引入javax.servlet-api等标准API依赖作用域设为provided。创建SpringBootServletInitializer你需要一个入口类继承SpringBootServletInitializer并重写configure方法。SpringBootApplication public class YourApplication extends SpringBootServletInitializer { Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(YourApplication.class); } public static void main(String[] args) { SpringApplication.run(YourApplication.class, args); } }执行mvn clean package生成WAR文件。4.3 部署至外部TongWeb服务器服务器安装与基础配置在目标服务器上安装TongWeb完成基础的JDK路径、端口、内存等配置。重点了解其管理控制台通常是一个Web应用的访问方式。应用部署将上一步生成的WAR包放置到TongWeb的webapps目录下类似于TomcatTongWeb会自动解压部署。或者通过TongWeb的管理控制台上传WAR包进行部署这种方式可以更灵活地配置上下文路径、虚拟主机等。数据源与连接池配置如果应用使用数据库通常不建议在应用内配置数据源。应在TongWeb控制台中配置JNDI数据源然后在SpringBoot应用中通过spring.datasource.jndi-name属性来引用。这是企业级部署的规范做法便于运维统一管理数据库连接。spring: datasource: jndi-name: java:comp/env/jdbc/YourDataSource启动与验证启动TongWeb服务器观察日志。访问应用进行全面的功能、性能和压力测试。5. 深度适配高级特性与性能调优5.1 会话Session集群与持久化在单机部署时Session通常不是问题。但在集群环境下Tomcat常用的Session复制如DeltaManager或第三方存储如Redis在TongWeb中需要有对应的解决方案。TongWeb集群会话东方通TongWeb通常提供自己的会话复制机制。你需要查阅其管理手册配置集群节点间的通信如组播地址、端口并开启应用的分布式会话支持。这可能需要在TongWeb的服务器配置文件如server.xml或专属配置文件中进行设置而不是在SpringBoot应用配置里。Spring Session集成更通用和推荐的做法是使用Spring Session将会话存储后端如Redis、数据库与具体的应用服务器解耦。这样无论底层是Tomcat、TongWeb还是其他容器会话管理逻辑都是一致的。迁移到TongWeb后只需确保Spring Session和所选存储后端的依赖和配置正确即可。5.2 线程池与连接器优化TongWeb和Tomcat的线程模型类似但参数名称和默认值可能有差异。生产环境部署前必须根据实际负载调整这些参数。关键调优参数示例需参考TongWeb官方文档确认参数含义Tomcat配置示例TongWeb配置可能位置调优建议最大工作线程数server.tomcat.max-threadsserver.tongweb.max-threads或 TongWebserver.xml根据CPU核心数和I/O等待时间计算通常建议在50-500之间。公式线程数 CPU核数 * (1 平均等待时间/平均计算时间)。可先用200-250作为起点进行压测。最小空闲线程数server.tomcat.min-spare-threadsserver.tongweb.min-spare-threads设置一个基础值如20避免流量突增时频繁创建线程。最大连接数server.tomcat.max-connectionsserver.tongweb.max-connections限制同时处理的连接数防止资源耗尽。应大于max-threads。连接超时server.tomcat.connection-timeoutserver.tongweb.connection-timeout设置合理的超时时间如30-60秒释放闲置连接。URI编码server.tomcat.uri-encodingserver.tongweb.uri-encoding统一设置为UTF-8避免中文乱码。重要提示这些参数的最佳值需要通过监控和压测来确定。使用JVisualVM、Arthas等工具监控TongWeb的线程状态、内存使用和GC情况结合APM工具如SkyWalking观察应用性能进行迭代调优。5.3 类加载机制差异与冲突解决Tomcat和TongWeb的类加载器ClassLoader层次结构可能存在差异。这可能导致一些依赖包特别是那些与Servlet API、JSP、WebSocket等容器标准实现紧密相关的包在迁移后出现ClassNotFoundException、NoSuchMethodError或ClassCastException。排查与解决策略优先使用TongWeb提供的库对于servlet-api、jsp-api等规范API应使用TongWeb服务器lib目录下提供的版本或在Maven中将作用域设为provided。注意WebSocket实现如果应用使用了WebSocketSpringBoot默认可能依赖tomcat-embed-websocket。迁移后需要排除它并确认TongWeb的WebSocket实现是否兼容或引入TongWeb对应的客户端库。使用mvn dependency:tree分析仔细查看依赖树检查是否有多个不同版本的相同jar包被引入。使用exclusion标签排除冲突的传递性依赖。日志分析关注启动时WARN或ERROR级别的日志特别是关于类加载、重复jar包、API不兼容的警告信息它们是解决问题的关键线索。6. 常见问题排查与实战技巧实录在实际迁移过程中我遇到了不少典型问题。这里记录下排查思路和解决方法希望能帮你快速定位。6.1 启动失败找不到主类或Servlet容器工厂现象应用启动失败报错“Unable to start embedded web server”或“No ServletWebServerFactory bean found”。排查检查是否成功排除了spring-boot-starter-tomcat。检查tongweb-spring-boot-starter依赖是否被正确引入版本是否兼容。检查项目依赖中是否还存在其他Servlet容器的Starter如Jetty、Undertow造成冲突。解决确保依赖树干净只保留一个有效的ServletWebServerFactory实现。6.2 静态资源或JSP页面404现象应用能启动API接口正常但访问静态文件.html,.js,.css或JSP页面返回404。排查静态资源检查SpringBoot的静态资源路径配置spring.web.resources.static-locations。确认文件是否被打包到了WAR或JAR的正确位置通常是classpath:/static/,classpath:/public/。JSP页面确认JSP依赖已添加。确认视图解析器前缀prefix配置正确指向JSP文件的实际目录如/WEB-INF/jsp/。关键一步检查TongWeb是否启用了JSP编译功能。有时需要在TongWeb的web.xml应用的或全局的或管理控制台中开启JSP支持。解决对照TongWeb的文档确认其JSP处理方式并调整应用配置或服务器配置。6.3 日志乱码问题现象控制台或日志文件中中文输出显示为乱码。排查这是一个非常经典且高频的问题。根源在于Java应用的输入/输出流编码、日志框架编码、操作系统终端编码以及TongWeb服务器自身日志编码的不一致。系统性解决方案应用层面确保你的application.yml中设置了正确的字符编码。spring: http: encoding: charset: UTF-8 enabled: true force: true server: tongweb: uri-encoding: UTF-8JVM参数在启动脚本中无论是直接运行JAR还是通过TongWeb启动添加JVM参数-Dfile.encodingUTF-8。日志框架在logback-spring.xml或log4j2.xml中明确指定控制台和文件输出的编码为UTF-8。!-- Logback 示例 -- appender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder charsetUTF-8/charset pattern.../pattern /encoder /appenderTongWeb服务器日志登录TongWeb管理控制台找到日志配置模块检查其输出文件的编码设置也修改为UTF-8。操作系统/终端确保部署服务器的系统 locale 和 SSH 终端如Xshell, SecureCRT的字符编码也设置为 UTF-8。6.4 内存配置与溢出OOM问题现象应用在TongWeb中运行一段时间后出现OutOfMemoryError。排查区分内存区域是堆内存Heap溢出还是元空间Metaspace或直接内存Direct Memory溢出错误信息会指明。分析堆转储在JVM参数中添加-XX:HeapDumpOnOutOfMemoryError -XX:HeapDumpPath/path/to/dump在OOM发生时自动生成堆转储文件。使用MATMemory Analyzer Tool或JVisualVM分析该文件找出内存中占比最大的对象和引用链。解决与调优调整TongWeb启动参数在TongWeb的启动脚本如startserver.sh或管理控制台的JVM参数配置处中根据服务器物理内存合理设置。# 示例设置堆内存、元空间并启用GC日志 JAVA_OPTS-Xms4g -Xmx8g -XX:MetaspaceSize256m -XX:MaxMetaspaceSize512m -XX:PrintGCDetails -XX:PrintGCDateStamps -Xloggc:/path/to/gc.log应用代码检查排查是否存在内存泄漏如静态集合不当引用、未关闭的资源数据库连接、文件流、HTTP连接、大量缓存未设置过期等。会话数据检查HttpSession中是否存储了过大的对象。考虑将大数据存储到外部缓存如RedisSession中只存ID。6.5 数据库连接池配置异常现象应用启动后访问数据库的请求很慢或报连接超时、连接不可用。排查如果使用TongWeb的JNDI数据源首先在TongWeb管理控制台测试数据源连接是否成功。检查连接池配置参数是否合理特别是初始连接数、最大连接数、超时时间、验证查询等。查看TongWeb和应用的日志寻找关于数据库连接的WARN或ERROR信息。解决JNDI配置确保TongWeb中数据源的JNDI名称与应用中spring.datasource.jndi-name配置的值完全一致包括java:comp/env/前缀。连接池参数根据数据库性能和并发请求量调整。例如初始连接数不宜过大最大连接数要小于数据库允许的最大连接数。设置合理的连接空闲超时和生存时间避免连接僵死。驱动兼容性确保TongWeb的lib目录下或应用WEB-INF/lib中放置的数据库驱动JAR版本与目标数据库版本兼容。迁移工作完成后并不意味着结束。建立一个简单的监控面板观察应用在TongWeb上的核心指标CPU、内存、线程数、响应时间、错误率并与之前在Tomcat环境下的基线数据进行对比。这不仅能验证迁移是否成功更能为后续的性能容量规划提供数据支撑。整个迁移过程本质上是对应用运行环境的一次深度梳理很多平时隐藏的问题会在切换容器时暴露出来解决它们应用会变得更加健壮。
1. 项目概述从Tomcat到东方通TongWeb的国产化迁移最近在做一个信创国产化适配的项目核心任务之一就是把SpringBoot应用默认内嵌的Tomcat服务器替换成国产的东方通TongWeb应用服务器。这活儿听起来好像就是换个依赖包改改配置但真干起来从环境准备、依赖冲突排查到部署调优每一步都可能藏着“坑”。很多团队在初次接触国产中间件时容易把问题想简单结果在部署阶段卡住影响项目进度。今天我就结合最近的实际迁移经验把从SpringBoot Tomcat切换到SpringBoot TongWeb的完整路径、核心原理和避坑要点梳理一遍目标是让你看完就能动手少走弯路。简单来说这个迁移的核心价值在于满足特定领域对软件基础设施国产化的要求。SpringBoot以其“约定大于配置”的便捷性著称其默认的Web容器是Tomcat。而东方通TongWeb作为一款成熟的国产Java应用服务器需要在SpringBoot框架下无缝替换Tomcat并保证应用功能、性能的稳定。这个过程不仅涉及依赖的变更更深层次的是对两类服务器在类加载机制、配置管理、会话处理等底层差异的兼容性适配。无论你是负责迁移的开发还是需要了解国产化技术的架构师掌握这套流程都至关重要。2. 迁移前的核心思路与准备工作2.1 理解替换的本质不仅仅是换个JAR包很多人以为替换Tomcat就是排除spring-boot-starter-tomcat然后引入TongWeb的客户端JAR包。这个操作没错但这只是表面。更深层的理解是我们是在替换SpringBoot内嵌的Servlet容器实现。SpringBoot通过spring-boot-starter-web默认引入了Tomcat。其自动装配机制会根据类路径下的容器类自动创建相应的ServletWebServerFactory。我们的目标就是让SpringBoot检测到TongWeb的相关类并转而使用TongWeb的工厂来创建Web服务器实例。因此准备工作必须细致。2.2 环境与依赖的精准准备首先你需要从东方通官方获取必要的资源。通常包括TongWeb应用服务器的安装包用于本地部署测试和了解其目录结构以及最重要的——TongWeb与SpringBoot集成的客户端JAR包。这个客户端JAR可能命名为tongweb-spring-boot-starter或类似的是关键它包含了TongWeb的ServletWebServerFactory实现以及相关的自动配置类。依赖调整示例Maven 在你的pom.xml中核心操作如下dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId !-- 关键排除默认的Tomcat -- exclusions exclusion groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-tomcat/artifactId /exclusion /exclusions /dependency !-- 引入TongWeb的SpringBoot Starter -- dependency groupIdcom.tongtech/groupId !-- 具体GroupId以官方为准 -- artifactIdtongweb-spring-boot-starter/artifactId version${tongweb.starter.version}/version /dependency注意tongweb-spring-boot-starter的版本需要与你的SpringBoot版本以及目标TongWeb服务器版本严格匹配。版本不匹配是启动失败最常见的原因之一务必查阅官方提供的兼容性矩阵。JDK版本确认检查你的项目JDK版本是否在TongWeb支持范围内。国产中间件对JDK版本可能比较敏感特别是从JDK 8升级到11或17时要留意模块化Module带来的变化。3. 核心配置解析与适配要点3.1 配置文件的关键调整迁移后原来针对Tomcat的server.tomcat.*配置项将不再生效。你需要将配置迁移到TongWeb的命名空间下。通常TongWeb Starter会定义类似server.tongweb.*的配置前缀。application.yml 配置示例对比# 原Tomcat配置部分失效 server: port: 8080 tomcat: max-threads: 200 uri-encoding: UTF-8 # 其他Tomcat特有配置... # 迁移后TongWeb配置示例具体属性名需参考官方文档 server: port: 8080 tongweb: max-threads: 200 min-spare-threads: 20 connection-timeout: 60000 uri-encoding: UTF-8 # 可能还有TongWeb特有的配置如工作目录、JSP支持开关等实操心得不要想当然地认为配置项名称只是简单地从tomcat换成tongweb。最可靠的方法是在引入Starter依赖后利用IDE的自动提示功能查看server.tongweb下有哪些可配置属性。或者直接查阅TongWeb官方提供的SpringBoot集成文档。3.2 处理JSP与静态资源的差异如果你的应用使用了JSP这里需要特别注意。Tomcat默认内置了Jasper引擎来处理JSP。而TongWeb可能使用不同的JSP实现或者需要显式开启支持。依赖检查确保项目中包含了JSP相关的依赖例如javax.servlet:jstl和org.apache.tomcat.embed:tomcat-embed-jasper注意这个依赖在TongWeb环境下可能仍需保留因为它是JSP编译引擎与容器无关但最好确认TongWeb Starter是否已包含或推荐特定版本。视图解析器配置在Spring MVC配置中检查InternalResourceViewResolver的前后缀设置是否正确指向你的JSP文件位置。静态资源路径Tomcat和TongWeb对静态资源如图片、CSS、JS的默认处理方式可能一致但如果你之前通过server.tomcat.basedir或webapp目录做了特殊配置需要找到TongWeb对应的配置项进行迁移。一个常见问题应用启动后访问JSP页面报错“JSP support is not available”或类似信息。这通常是因为TongWeb的JSP支持没有正确启用。解决方法除了检查依赖可能还需要在application.yml中明确配置server: tongweb: jsp: enabled: true # 如果TongWeb提供此配置4. 完整迁移与部署实操流程4.1 本地开发环境集成与测试依赖更新与编译完成pom.xml的修改后执行mvn clean compile确保没有依赖冲突。常见的冲突可能来自Servlet API、WebSocket等与容器紧密相关的包。使用mvn dependency:tree命令仔细检查。本地启动直接运行SpringBoot应用的Main类。如果集成正确控制台启动日志中应该看到TongWeb相关的标识而不是Tomcat。例如日志开头可能显示“Starting service [TongWeb]”或类似信息。基础功能测试启动后立即对核心功能进行冒烟测试访问首页或健康检查接口。测试关键业务API。如果有JSP页面访问验证渲染是否正确。测试文件上传下载、会话Session保持等功能。4.2 构建可部署的WAR包可选但重要虽然SpringBoot推荐打可执行JAR包并内嵌容器但在企业级生产环境中特别是使用TongWeb这类独立应用服务器时更常见的部署方式是打WAR包然后部署到外部的TongWeb服务器实例中。这种方式更利于运维统一管理、监控和集群部署。步骤修改打包方式在pom.xml中将packagingjar/packaging改为packagingwar/packaging。排除内嵌容器确保已经排除了spring-boot-starter-tomcat并且不引入TongWeb的Starter依赖因为容器由外部提供。取而代之的是需要引入javax.servlet-api等标准API依赖作用域设为provided。创建SpringBootServletInitializer你需要一个入口类继承SpringBootServletInitializer并重写configure方法。SpringBootApplication public class YourApplication extends SpringBootServletInitializer { Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(YourApplication.class); } public static void main(String[] args) { SpringApplication.run(YourApplication.class, args); } }执行mvn clean package生成WAR文件。4.3 部署至外部TongWeb服务器服务器安装与基础配置在目标服务器上安装TongWeb完成基础的JDK路径、端口、内存等配置。重点了解其管理控制台通常是一个Web应用的访问方式。应用部署将上一步生成的WAR包放置到TongWeb的webapps目录下类似于TomcatTongWeb会自动解压部署。或者通过TongWeb的管理控制台上传WAR包进行部署这种方式可以更灵活地配置上下文路径、虚拟主机等。数据源与连接池配置如果应用使用数据库通常不建议在应用内配置数据源。应在TongWeb控制台中配置JNDI数据源然后在SpringBoot应用中通过spring.datasource.jndi-name属性来引用。这是企业级部署的规范做法便于运维统一管理数据库连接。spring: datasource: jndi-name: java:comp/env/jdbc/YourDataSource启动与验证启动TongWeb服务器观察日志。访问应用进行全面的功能、性能和压力测试。5. 深度适配高级特性与性能调优5.1 会话Session集群与持久化在单机部署时Session通常不是问题。但在集群环境下Tomcat常用的Session复制如DeltaManager或第三方存储如Redis在TongWeb中需要有对应的解决方案。TongWeb集群会话东方通TongWeb通常提供自己的会话复制机制。你需要查阅其管理手册配置集群节点间的通信如组播地址、端口并开启应用的分布式会话支持。这可能需要在TongWeb的服务器配置文件如server.xml或专属配置文件中进行设置而不是在SpringBoot应用配置里。Spring Session集成更通用和推荐的做法是使用Spring Session将会话存储后端如Redis、数据库与具体的应用服务器解耦。这样无论底层是Tomcat、TongWeb还是其他容器会话管理逻辑都是一致的。迁移到TongWeb后只需确保Spring Session和所选存储后端的依赖和配置正确即可。5.2 线程池与连接器优化TongWeb和Tomcat的线程模型类似但参数名称和默认值可能有差异。生产环境部署前必须根据实际负载调整这些参数。关键调优参数示例需参考TongWeb官方文档确认参数含义Tomcat配置示例TongWeb配置可能位置调优建议最大工作线程数server.tomcat.max-threadsserver.tongweb.max-threads或 TongWebserver.xml根据CPU核心数和I/O等待时间计算通常建议在50-500之间。公式线程数 CPU核数 * (1 平均等待时间/平均计算时间)。可先用200-250作为起点进行压测。最小空闲线程数server.tomcat.min-spare-threadsserver.tongweb.min-spare-threads设置一个基础值如20避免流量突增时频繁创建线程。最大连接数server.tomcat.max-connectionsserver.tongweb.max-connections限制同时处理的连接数防止资源耗尽。应大于max-threads。连接超时server.tomcat.connection-timeoutserver.tongweb.connection-timeout设置合理的超时时间如30-60秒释放闲置连接。URI编码server.tomcat.uri-encodingserver.tongweb.uri-encoding统一设置为UTF-8避免中文乱码。重要提示这些参数的最佳值需要通过监控和压测来确定。使用JVisualVM、Arthas等工具监控TongWeb的线程状态、内存使用和GC情况结合APM工具如SkyWalking观察应用性能进行迭代调优。5.3 类加载机制差异与冲突解决Tomcat和TongWeb的类加载器ClassLoader层次结构可能存在差异。这可能导致一些依赖包特别是那些与Servlet API、JSP、WebSocket等容器标准实现紧密相关的包在迁移后出现ClassNotFoundException、NoSuchMethodError或ClassCastException。排查与解决策略优先使用TongWeb提供的库对于servlet-api、jsp-api等规范API应使用TongWeb服务器lib目录下提供的版本或在Maven中将作用域设为provided。注意WebSocket实现如果应用使用了WebSocketSpringBoot默认可能依赖tomcat-embed-websocket。迁移后需要排除它并确认TongWeb的WebSocket实现是否兼容或引入TongWeb对应的客户端库。使用mvn dependency:tree分析仔细查看依赖树检查是否有多个不同版本的相同jar包被引入。使用exclusion标签排除冲突的传递性依赖。日志分析关注启动时WARN或ERROR级别的日志特别是关于类加载、重复jar包、API不兼容的警告信息它们是解决问题的关键线索。6. 常见问题排查与实战技巧实录在实际迁移过程中我遇到了不少典型问题。这里记录下排查思路和解决方法希望能帮你快速定位。6.1 启动失败找不到主类或Servlet容器工厂现象应用启动失败报错“Unable to start embedded web server”或“No ServletWebServerFactory bean found”。排查检查是否成功排除了spring-boot-starter-tomcat。检查tongweb-spring-boot-starter依赖是否被正确引入版本是否兼容。检查项目依赖中是否还存在其他Servlet容器的Starter如Jetty、Undertow造成冲突。解决确保依赖树干净只保留一个有效的ServletWebServerFactory实现。6.2 静态资源或JSP页面404现象应用能启动API接口正常但访问静态文件.html,.js,.css或JSP页面返回404。排查静态资源检查SpringBoot的静态资源路径配置spring.web.resources.static-locations。确认文件是否被打包到了WAR或JAR的正确位置通常是classpath:/static/,classpath:/public/。JSP页面确认JSP依赖已添加。确认视图解析器前缀prefix配置正确指向JSP文件的实际目录如/WEB-INF/jsp/。关键一步检查TongWeb是否启用了JSP编译功能。有时需要在TongWeb的web.xml应用的或全局的或管理控制台中开启JSP支持。解决对照TongWeb的文档确认其JSP处理方式并调整应用配置或服务器配置。6.3 日志乱码问题现象控制台或日志文件中中文输出显示为乱码。排查这是一个非常经典且高频的问题。根源在于Java应用的输入/输出流编码、日志框架编码、操作系统终端编码以及TongWeb服务器自身日志编码的不一致。系统性解决方案应用层面确保你的application.yml中设置了正确的字符编码。spring: http: encoding: charset: UTF-8 enabled: true force: true server: tongweb: uri-encoding: UTF-8JVM参数在启动脚本中无论是直接运行JAR还是通过TongWeb启动添加JVM参数-Dfile.encodingUTF-8。日志框架在logback-spring.xml或log4j2.xml中明确指定控制台和文件输出的编码为UTF-8。!-- Logback 示例 -- appender nameCONSOLE classch.qos.logback.core.ConsoleAppender encoder charsetUTF-8/charset pattern.../pattern /encoder /appenderTongWeb服务器日志登录TongWeb管理控制台找到日志配置模块检查其输出文件的编码设置也修改为UTF-8。操作系统/终端确保部署服务器的系统 locale 和 SSH 终端如Xshell, SecureCRT的字符编码也设置为 UTF-8。6.4 内存配置与溢出OOM问题现象应用在TongWeb中运行一段时间后出现OutOfMemoryError。排查区分内存区域是堆内存Heap溢出还是元空间Metaspace或直接内存Direct Memory溢出错误信息会指明。分析堆转储在JVM参数中添加-XX:HeapDumpOnOutOfMemoryError -XX:HeapDumpPath/path/to/dump在OOM发生时自动生成堆转储文件。使用MATMemory Analyzer Tool或JVisualVM分析该文件找出内存中占比最大的对象和引用链。解决与调优调整TongWeb启动参数在TongWeb的启动脚本如startserver.sh或管理控制台的JVM参数配置处中根据服务器物理内存合理设置。# 示例设置堆内存、元空间并启用GC日志 JAVA_OPTS-Xms4g -Xmx8g -XX:MetaspaceSize256m -XX:MaxMetaspaceSize512m -XX:PrintGCDetails -XX:PrintGCDateStamps -Xloggc:/path/to/gc.log应用代码检查排查是否存在内存泄漏如静态集合不当引用、未关闭的资源数据库连接、文件流、HTTP连接、大量缓存未设置过期等。会话数据检查HttpSession中是否存储了过大的对象。考虑将大数据存储到外部缓存如RedisSession中只存ID。6.5 数据库连接池配置异常现象应用启动后访问数据库的请求很慢或报连接超时、连接不可用。排查如果使用TongWeb的JNDI数据源首先在TongWeb管理控制台测试数据源连接是否成功。检查连接池配置参数是否合理特别是初始连接数、最大连接数、超时时间、验证查询等。查看TongWeb和应用的日志寻找关于数据库连接的WARN或ERROR信息。解决JNDI配置确保TongWeb中数据源的JNDI名称与应用中spring.datasource.jndi-name配置的值完全一致包括java:comp/env/前缀。连接池参数根据数据库性能和并发请求量调整。例如初始连接数不宜过大最大连接数要小于数据库允许的最大连接数。设置合理的连接空闲超时和生存时间避免连接僵死。驱动兼容性确保TongWeb的lib目录下或应用WEB-INF/lib中放置的数据库驱动JAR版本与目标数据库版本兼容。迁移工作完成后并不意味着结束。建立一个简单的监控面板观察应用在TongWeb上的核心指标CPU、内存、线程数、响应时间、错误率并与之前在Tomcat环境下的基线数据进行对比。这不仅能验证迁移是否成功更能为后续的性能容量规划提供数据支撑。整个迁移过程本质上是对应用运行环境的一次深度梳理很多平时隐藏的问题会在切换容器时暴露出来解决它们应用会变得更加健壮。
)
