Spring Boot迁移：将Spring 4 RESTful应用转为Spring Boot项目

阿华AIGC实验室

2026-5-19

迁移Spring 4 RESTful应用到Spring Boot的实操指南

我之前帮不少开发者做过这类Spring到Spring Boot的迁移，其实过程比你想象的顺畅很多——毕竟Spring Boot就是为了简化Spring的繁琐配置而生的。结合你提到的原有Spring 4项目结构，下面是一步步的实操方案：

1. 从零搭建Spring Boot基础项目

首先得创建一个干净的Spring Boot项目，有两种简单方式：

用Spring官方的初始化工具，选择对应的依赖：Spring Web（支撑REST接口）、Spring Data JPA（对应原项目的实体层和持久层配置），再加上你原项目用的数据库驱动（比如MySQL、H2等）。
手动创建Maven/Gradle项目：在pom.xml里添加Spring Boot父依赖，再引入需要的starter依赖，比如：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.x</version> <!-- 选兼容Spring 4的版本，2.7.x支持Java 8，和Spring 4的环境匹配 -->
    <relativePath/>
</parent>

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <!-- 数据库驱动，比如MySQL -->
    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <scope>runtime</scope>
    </dependency>
</dependencies>

2. 迁移原有Java代码包

这一步很直接，几乎不需要修改代码：

把原项目里的实体类（Entity）、DAO/Repository、Service、Controller这些代码包，直接复制到Spring Boot项目的src/main/java目录下。
注意包结构：把Spring Boot的主启动类（带@SpringBootApplication的类）放在所有业务代码的根包下，比如原项目包是com.tjholmes.phonebook，那主启动类就放在这个包下，这样Spring Boot会自动扫描所有子包的组件，不需要额外配置扫描路径。
注解兼容检查：原Spring 4的@Controller、@Service、@Repository、@RequestMapping这些注解，Spring Boot完全兼容。如果是纯REST接口，建议把@Controller换成@RestController（省去每个方法加@ResponseBody的麻烦），但不换也能正常运行。

3. 替换原XML配置（phonebook-entity-context.xml）

原项目的XML配置是核心迁移点，Spring Boot用配置文件+注解替代XML，对应原XML里的配置：

3.1 数据库与JPA配置

原XML里的数据源、EntityManagerFactory、JPA属性，都可以放到application.properties（或application.yml）里：

# 数据库连接配置，对应原XML里的dataSource bean
spring.datasource.url=jdbc:mysql://localhost:3306/phonebook
spring.datasource.username=your_db_user
spring.datasource.password=your_db_pwd
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# JPA配置，对应原XML里的entityManagerFactory和hibernate属性
spring.jpa.hibernate.ddl-auto=update # 对应原项目的表生成策略
spring.jpa.show-sql=true # 开启SQL打印，方便调试
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect # 适配你的数据库版本

3.2 组件与Repository扫描

原XML里的<context:component-scan>和<jpa:repositories>，Spring Boot的@SpringBootApplication注解已经包含了@ComponentScan和@EnableJpaRepositories，只要包结构符合要求（主启动类在根包），就不需要额外配置。

3.3 自定义Bean（如果有）

如果原XML里有自定义的Bean（比如特殊的数据源、拦截器等），可以用@Configuration类来替代：

@Configuration
public class CustomConfig {
    // 比如原XML里的自定义数据源
    @Bean
    public DataSource customDataSource() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource();
        // 这里写原XML里的数据源配置逻辑
        dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");
        dataSource.setUrl("jdbc:mysql://localhost:3306/phonebook");
        dataSource.setUsername("your_db_user");
        dataSource.setPassword("your_db_pwd");
        return dataSource;
    }
}