从Maven到SpringBoot：Java项目现代化改造实践-拓冰建站

1. 项目概述

作为一名Java开发者，我最近接手了一个遗留的Maven项目，需要将其改造为SpringBoot项目。这个改造过程让我深刻体会到SpringBoot带来的便利性，也踩了不少坑。今天就来详细记录下这次改造的全过程，希望能帮到有类似需求的同行。

这个原始项目是一个典型的Maven多模块项目，包含了web、service、dao等标准分层结构。项目使用Spring 4.x框架，配置了大量XML文件，部署时需要依赖外部Tomcat服务器。随着业务发展，这种架构暴露出启动慢、配置复杂、依赖管理困难等问题。

2. 改造前的准备工作

2.1 环境检查与依赖梳理

在开始改造前，我首先对现有项目进行了全面梳理：

Maven依赖分析：执行mvn dependency:tree命令，输出完整的依赖树，识别出所有直接和传递依赖
配置文件整理：收集所有Spring XML配置文件（applicationContext-*.xml）、web.xml等
启动类检查：确认现有的主启动类和初始化逻辑
特殊配置识别：标记出所有与特定环境相关的配置（如数据源、消息队列等）

提示：这个阶段建议创建一个checklist文档，记录所有需要迁移的组件和配置，避免遗漏。

2.2 SpringBoot版本选择

基于项目现状，我选择了SpringBoot 2.7.x版本，主要考虑：

与现有Spring 4.x的兼容性较好
长期支持(LTS)版本，稳定性有保障
社区资源丰富，遇到问题容易找到解决方案

在pom.xml中添加SpringBoot父POM依赖：

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.3</version> <relativePath/> </parent>

3. 核心改造步骤

3.1 依赖项改造

将原有Maven依赖替换为对应的SpringBoot starter：

原依赖类型	SpringBoot Starter替代方案
Spring MVC	spring-boot-starter-web
MyBatis	mybatis-spring-boot-starter
JDBC	spring-boot-starter-jdbc
测试	spring-boot-starter-test

示例改造：

<!-- 改造前 --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>4.3.18.RELEASE</version> </dependency> <!-- 改造后 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>

3.2 配置迁移

3.2.1 XML配置转Java Config

将原有的XML配置转换为基于注解的Java配置：

@Configuration public class AppConfig { @Bean public DataSource dataSource() { // 替代原来的dataSource bean定义 HikariDataSource ds = new HikariDataSource(); ds.setJdbcUrl(env.getProperty("spring.datasource.url")); // 其他配置... return ds; } // 其他bean定义... }

3.2.2 属性文件整合

将分散在各处的properties文件整合到application.yml中：

spring: datasource: url: jdbc:mysql://localhost:3306/mydb username: root password: 123456 driver-class-name: com.mysql.jdbc.Driver servlet: multipart: max-file-size: 10MB

3.3 启动类改造

创建SpringBoot主启动类：

@SpringBootApplication public class Application extends SpringBootServletInitializer { @Override protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) { return builder.sources(Application.class); } public static void main(String[] args) { SpringApplication.run(Application.class, args); } }

注意：如果项目需要保留war包部署能力，需要继承SpringBootServletInitializer

4. 特殊场景处理

4.1 静态资源处理

SpringBoot默认静态资源位置：

/static
/public
/resources
/META-INF/resources

如果原有项目使用不同目录结构，可以通过配置调整：

spring: web: resources: static-locations: classpath:/custom-static/

4.2 过滤器配置

将web.xml中的过滤器迁移为Spring Bean：

@Bean public FilterRegistrationBean<MyFilter> myFilter() { FilterRegistrationBean<MyFilter> registration = new FilterRegistrationBean<>(); registration.setFilter(new MyFilter()); registration.addUrlPatterns("/*"); registration.setOrder(1); return registration; }

4.3 多数据源配置

对于多数据源场景，需要手动配置每个数据源：

@Configuration public class DataSourceConfig { @Primary @Bean(name = "primaryDataSource") @ConfigurationProperties(prefix = "spring.datasource.primary") public DataSource primaryDataSource() { return DataSourceBuilder.create().build(); } @Bean(name = "secondaryDataSource") @ConfigurationProperties(prefix = "spring.datasource.secondary") public DataSource secondaryDataSource() { return DataSourceBuilder.create().build(); } }

5. 测试与验证

5.1 单元测试改造

使用SpringBoot测试支持：

@SpringBootTest @RunWith(SpringRunner.class) public class MyServiceTest { @Autowired private MyService myService; @Test public void testBusinessLogic() { // 测试代码 } }

5.2 集成测试要点

使用@SpringBootTest加载完整应用上下文
测试配置文件使用test profile
考虑使用Testcontainers进行数据库等基础设施测试

6. 常见问题与解决方案

6.1 依赖冲突解决

使用Maven依赖树分析工具识别冲突：

mvn dependency:tree -Dverbose

常见解决方式：

使用<exclusions>排除冲突依赖
通过<dependencyManagement>统一版本

6.2 配置不生效问题

排查步骤：

确认配置属性拼写正确
检查是否有多个配置源冲突
使用@ConfigurationProperties的prefix是否正确
查看SpringBoot启动日志中的配置绑定报告

6.3 启动类扫描问题

如果组件无法自动扫描到，可以：

明确指定扫描包：@SpringBootApplication(scanBasePackages = "com.myapp")
使用@ComponentScan手动配置扫描路径

7. 性能优化建议

7.1 启动速度优化

使用SpringBoot 2.4+的延迟初始化：spring.main.lazy-initialization=true
移除不必要的自动配置：@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
分析启动过程：添加-Ddebug参数查看自动配置报告

7.2 内存优化

调整JVM参数：-Xms256m -Xmx512m
使用SpringBoot Actuator监控内存使用
定期进行内存分析，查找内存泄漏

8. 部署方案升级

8.1 可执行JAR部署

mvn clean package java -jar target/myapp-0.0.1-SNAPSHOT.jar

8.2 Docker化部署

创建Dockerfile示例：

FROM openjdk:11-jre COPY target/myapp-0.0.1-SNAPSHOT.jar /app.jar ENTRYPOINT ["java","-jar","/app.jar"]

构建并运行：

docker build -t myapp . docker run -p 8080:8080 myapp

9. 监控与运维

9.1 Actuator集成

添加依赖：

<dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency>

配置端点暴露：

management: endpoints: web: exposure: include: health,info,metrics

9.2 日志配置

使用Logback的SpringBoot配置：

<!-- src/main/resources/logback-spring.xml --> <configuration> <include resource="org/springframework/boot/logging/logback/defaults.xml"/> <include resource="org/springframework/boot/logging/logback/console-appender.xml"/> <root level="INFO"> <appender-ref ref="CONSOLE"/> </root> </configuration>