本文系统梳理了将基于 jax-rs 和 websphere liberty 的大型遗留 rest 项目迁移到 spring boot 的关键步骤，涵盖结构重构、依赖调整、注解替换与本地验证全流程，助力企业平滑上云（如 azure）并提升可维护性。
本文系统梳理了将基于 jax-rs 和 websphere liberty 的大型遗留 rest 项目迁移到 spring boot 的关键步骤，涵盖结构重构、依赖调整、注解替换与本地验证全流程，助力企业平滑上云（如 azure）并提升可维护性。
将传统 JAX-RS 项目迁移至 Spring Boot 并非“一键转换”，而是一次有规划的架构演进。核心目标是复用业务逻辑，剥离容器耦合，构建轻量、可移植、云就绪的新应用。以下为经生产验证的分步实施路径：
一、初始化 Spring Boot 工程骨架
使用 Spring Initializr 创建基础项目，推荐依赖：
- spring-boot-starter-web（提供内嵌 Tomcat + REST 支持）
- spring-boot-starter-validation（替代 JAX-RS Bean Validation）
- spring-boot-starter-data-jpa（如原项目含 JPA，需适配 Hibernate）
- spring-boot-starter-actuator（增强可观测性）
确保打包方式为 jar（非 war），避免 WebSphere 特定部署结构干扰。
二、结构迁移与精简
- 包结构对齐：保留原有业务包层级（如 com.example.api, com.example.service, com.example.model），避免大规模重命名，降低理解成本。
- 清理冗余模块：彻底移除 Liberty/EJB 相关构件——EAR/WAR 打包目录、ejbrefs-repl.xml、pipeline_config、自定义 RequestProcessor 等。Spring Boot 通过自动配置替代这些声明式管道。
- 统一构建入口：合并多模块 Maven 结构，仅保留一个 pom.xml，删除 <modules> 声明，并引入 spring-boot-maven-plugin 实现可执行 JAR 构建。
三、核心注解与依赖注入重构
| JAX-RS / Java EE 注解 | Spring Boot 替代方案 | 说明 |
|---|---|---|
| @Inject | @Autowired | Spring 默认按类型注入，建议配合 @Qualifier 显式指定 Bean |
| @Context（UriInfo, SecurityContext） | @Autowired + HttpServletRequest/SecurityContextHolder | 使用 RequestContextHolder 获取请求上下文 |
| @PathParam/@QueryParam | @PathVariable/@RequestParam | 控制器方法参数级映射保持语义一致 |
| @Provider（异常处理器） | @ControllerAdvice + @ExceptionHandler | 统一全局异常处理，返回标准 ResponseEntity |
示例控制器迁移对比：
// 迁移前（JAX-RS）
@Path("/users")
public class UserResource {
@Inject private UserService userService;
@GET @Path("/{id}")
public Response getUser(@PathParam("id") Long id) {
return Response.ok(userService.findById(id)).build();
}
}
// 迁移后（Spring Boot）
@RestController
@RequestMapping("/users")
public class UserController {
@Autowired private UserService userService;
@GetMapping("/{id}")
public ResponseEntity<User> getUser(@PathVariable Long id) {
return ResponseEntity.ok(userService.findById(id));
}
}四、配置与启动集成
- 创建 src/main/resources/application.properties，配置服务器端口、日志、数据库等：
server.port=8080 spring.application.name=user-api logging.level.com.example=DEBUG spring.datasource.url=jdbc:h2:mem:testdb
- 编写启动类（必须位于根包下，确保组件扫描覆盖全部业务包）：
@SpringBootApplication public class LegacyApiApplication { public static void main(String[] args) { SpringApplication.run(LegacyApiApplication.class, args); } }
五、渐进式验证与注意事项
- ✅ 本地优先：先在内嵌 Tomcat 运行并通过 curl 或 Postman 验证核心接口，再推进到 Azure App Service 或 AKS。
- ⚠️ 事务管理：若原项目使用 @Transactional（JTA），需切换为 Spring 的 @Transactional（默认 JDBC 事务），必要时配置 JtaTransactionManager。
- ⚠️ 安全迁移：@RolesAllowed → Spring Security 的 @PreAuthorize("hasRole('ADMIN')")，需引入 spring-boot-starter-security 并配置 SecurityFilterChain。
- ⚠️ 第三方库兼容性：检查 JAXB、JSON-B 等旧库是否与 Spring Boot 3.x（Jakarta EE 9+）冲突，建议统一使用 Jackson。
迁移本质是“解耦—重构—验证”循环。不追求一步到位，可按业务域分批迁移，配合契约测试（如 Spring Cloud Contract）保障接口一致性。最终成果不仅是技术栈升级，更是为云原生运维（CI/CD、健康检查、Metrics 暴露）奠定坚实基础。
