SpringBoot项目迁移到国产东方通TongWeb7.0的完整避坑指南（附依赖清单）
在国产化技术替代浪潮中，应用服务器的迁移是许多Java开发者必须面对的挑战。本文将分享从Tomcat迁移到东方通TongWeb7.0的完整过程，重点解决实际迁移中遇到的各类问题，提供经过验证的解决方案。
1. 迁移前的准备工作
迁移工作开始前，需要明确几个关键点：
- 评估现有项目结构：检查SpringBoot版本、依赖树和自定义配置
- 获取TongWeb资源：从官方渠道下载最新版TongWeb7.0及其SpringBoot适配组件
- 建立测试环境：准备独立的开发环境用于迁移测试
依赖冲突检查是首要任务。执行以下命令查看当前项目的依赖树：
mvn dependency:tree -Dverbose > dependency.txt这个命令会生成详细的依赖关系报告，帮助我们识别潜在的冲突点。特别要注意Servlet API、JSP和WebSocket相关的依赖。
提示：建议在迁移前创建新的Git分支，确保可以随时回退到稳定版本。
2. 核心依赖调整实战
2.1 排除Tomcat依赖
SpringBoot默认内嵌Tomcat，首先需要排除这些内置依赖。在pom.xml中修改spring-boot-starter-web的配置：
<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>2.2 添加TongWeb核心依赖
TongWeb7.0需要添加以下关键依赖：
| 依赖项 | 作用 | 版本要求 |
|---|---|---|
| tongweb-spring-boot-starter | SpringBoot适配器 | 7.0.E.5 |
| tongweb-embed | 嵌入式容器核心 | 7.0.E.5 |
| tongweb-javax-servlet | Servlet API实现 | 4.0.0 |
完整依赖配置示例：
<dependency> <groupId>com.tongweb.springboot</groupId> <artifactId>tongweb-spring-boot-starter-2.x</artifactId> <version>7.0.E.5</version> </dependency> <dependency> <groupId>com.tongweb</groupId> <artifactId>tongweb-embed</artifactId> <version>7.0.E.5</version> </dependency>3. 常见问题与解决方案
3.1 ClassNotFoundException问题排查
迁移过程中最常见的错误是类找不到异常。解决方法包括：
- 检查依赖完整性：确认所有必需的TongWeb组件都已添加
- 版本一致性：确保所有TongWeb相关依赖使用相同版本号
- 类加载顺序：在IDE中检查类加载路径
典型缺失依赖示例：
<dependency> <groupId>com.tongweb</groupId> <artifactId>tongweb-javax-security-auth-message-api</artifactId> <version>1.1.0</version> </dependency>3.2 配置项迁移指南
application.yml需要做以下调整：
server: tongweb: license: type: file path: classpath:license.dat uri-encoding: UTF-8 max-threads: 800关键配置说明：
- license配置：必须正确放置license.dat文件
- 线程池配置：根据实际负载调整max-threads
- 编码设置：确保与前端编码一致
4. 性能调优与监控
迁移完成后，建议进行以下优化：
- 连接池配置：调整TongWeb的连接池参数
- JVM参数优化：根据服务器配置调整内存设置
- 监控集成：添加TongWeb特有的监控端点
性能关键指标监控表：
| 指标 | 正常范围 | 监控方式 |
|---|---|---|
| 活跃线程数 | < max-threads的80% | JMX |
| 内存使用率 | < 70% | 内置监控 |
| 请求处理时间 | < 500ms | 日志分析 |
5. 完整依赖清单参考
经过实际项目验证的完整依赖列表：
<!-- TongWeb核心依赖 --> <dependency> <groupId>com.tongweb.springboot</groupId> <artifactId>tongweb-spring-boot-starter-2.x</artifactId> <version>7.0.E.5</version> </dependency> <dependency> <groupId>com.tongweb</groupId> <artifactId>tongweb-embed</artifactId> <version>7.0.E.5</version> </dependency> <!-- 补充依赖 --> <dependency> <groupId>com.tongweb</groupId> <artifactId>tongweb-javax-servlet</artifactId> <version>4.0.0</version> </dependency> <dependency> <groupId>com.tongweb</groupId> <artifactId>tongweb-embed-servlet</artifactId> <version>7.0.E.5_P2</version> </dependency>在实际迁移中，发现最大的坑是依赖版本的不匹配问题。建议先搭建最小可运行环境，再逐步添加业务模块，这样能快速定位问题所在。
