将轻量Jersey/Jetty代理服务迁移至Spring Boot 3.5的最佳实践咨询

端点迁移细节 #

• 把Jersey资源转成Spring Controller时，注意注解映射的细微差异：Jersey的@Path("{id:[0-9]+}")直接对应Spring的@GetMapping("/{id:\\d+}")；如果原端点用了矩阵参数（比如@MatrixParam），Spring默认不支持，要么用@RequestParam结合路径解析处理，要么自定义参数解析器，别硬写冗余逻辑。
• 原Jersey的@Produces/@Consumes对应Spring的@ResponseBody/@RequestBody，Spring Boot 3.x默认支持JSON/XML等主流格式，除非有自定义媒体类型，否则不用额外配置。
• 原Jersey通过@Context注入的UriInfo、HttpServletRequest等对象，在Spring里直接用@Autowired注入HttpServletRequest就行，或者通过ServletRequestAttributes获取上下文，不用手动传参。

配置与服务器替换 #

• 迁移配置到application.yml时，原Jetty的端口、线程池配置直接对应Spring Boot的server.port、server.jetty.threads.*——如果不想换Tomcat，直接引入spring-boot-starter-jetty依赖，原Jetty核心配置能平滑映射，不用改太多代码。
• 要是原项目有自定义Jetty Handler或Servlet，别直接删，先通过ServletRegistrationBean或JettyServerCustomizer注册到Spring Boot的嵌入式服务器里，等所有端点迁移完再逐步移除。

测试与依赖清理 #

• 迁移端点时优先复用原有测试用例，把Jersey的JerseyTest换成Spring Boot的@SpringBootTest+TestRestTemplate/MockMvc；原测试用了Mockito的话，用Spring Boot的@MockBean替代手动mock，能简化测试代码。
• 移除Jersey/Jetty依赖别一次性删完，先注释掉跑一遍所有测试，排查隐藏依赖——比如有些工具类用了Jersey的javax.ws.rs.core.Response，换成Spring的org.springframework.http.ResponseEntity就行。
• 注意Java 21兼容性：Spring Boot 3.5.x对Java 21支持没问题，但原Jersey代码里如果用了废弃的JDK API，比如javax.annotation包的注解，要换成jakarta.annotation（Spring Boot 3.x基于Jakarta EE 9+）。

其他实用提醒 #

• 原Jersey的ExceptionMapper全局异常映射，换成Spring的@RestControllerAdvice+@ExceptionHandler，逻辑更清晰，维护起来更方便。
• 要是原项目用Jersey客户端调用外部服务，建议换成Spring的RestTemplate或WebClient，后者是响应式的，更贴合Spring生态，还能通过@Bean统一配置超时、拦截器等。

内容的提问来源于stack exchange，提问作者Moncef Ahmane