从Tomcat 7迁移至Tomcat 10后POST服务触发500内部服务器错误

问题场景 #

将应用从Tomcat 7迁移到Tomcat 10，已完成所有javax包到jakarta对应包的替换，但调用POST接口/m1时出现500内部服务器错误，且接口方法内的logger.info("Invoked API : /sayHello")日志完全没有输出，说明请求未进入业务方法。

相关代码片段 #

服务类代码

import jakarta.ws.rs.Consumes;
import jakarta.ws.rs.GET;
import jakarta.ws.rs.HeaderParam;
import jakarta.ws.rs.POST;
import jakarta.ws.rs.Path;
import jakarta.ws.rs.Produces;
import jakarta.ws.rs.core.MediaType;

@Path("/m1")
@POST
@Produces({ MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML })
@Consumes({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
public String sayHello(AcceptRequest request, @HeaderParam("Accept") String contentType) {
    logger.info("Invoked API : /sayHello");
    return "Hello";
}

请求实体类代码

import jakarta.xml.bind.annotation.XmlAccessorType;
import jakarta.xml.bind.annotation.XmlElement;
import jakarta.xml.bind.annotation.XmlRootElement;
import jakarta.xml.bind.annotation.XmlAccessType;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.Logger;

@XmlRootElement(name="feature")
@XmlAccessorType(XmlAccessType.FIELD)
public class AcceptRequest {
    private static final Logger logger = LogManager.getLogger(AcceptRequest.class);
    
    @XmlElement(required = true)
    public String a;
    
    @XmlElement(required = true)
    public String b;
    
    @XmlElement(required = true)
    public String c;
}

排查方向与解决方案 #

1. 确认JAX-RS依赖的Jakarta兼容性 #

Tomcat 10基于Jakarta EE 9规范，所有JAX-RS相关依赖必须是支持Jakarta的版本：

• 替换旧的javax.ws.rs-api为jakarta.ws.rs-api（版本≥3.0）
• 若使用Jersey作为JAX-RS实现，必须升级到3.x版本（对应依赖如org.glassfish.jersey.core:jersey-server:3.0+）
• 若使用RESTEasy，升级到6.x版本，确保所有依赖都替换为jakarta前缀的包

2. 检查请求反序列化依赖 #

请求未进入方法，大概率是请求体无法反序列化为AcceptRequest对象：

• 如果请求是JSON格式，必须引入Jakarta版本的JSON提供者，比如Jackson的com.fasterxml.jackson.jakarta.rs:jackson-jakarta-rs-json-provider，旧的jackson-jaxrs-json-provider无法在Tomcat10中工作
• 确认请求的Content-Type头与接口@Consumes指定的类型一致（比如application/json或application/xml），不匹配会导致框架无法识别请求体
• 若使用XML请求，确保Tomcat中包含Jakarta XML Binding（JAXB）的实现，Tomcat10默认可能不包含，需手动引入jakarta.xml.bind:jakarta.xml.bind-api和对应的实现如com.sun.xml.bind:jaxb-impl（版本≥3.0）

3. 清理冲突依赖 #

排查项目中是否残留javax前缀的依赖，导致类加载冲突：

• 使用Maven的mvn dependency:tree命令查看依赖树，排除所有javax相关的依赖（比如javax.servlet-api、javax.ws.rs-api等）
• 确保web项目的WEB-INF/lib下没有javax开头的jar包

4. 查看Tomcat核心日志 #

应用日志未输出，直接查看Tomcat的核心日志定位问题：

• 检查TOMCAT_HOME/logs/catalina.log或localhost.log，里面会包含500错误的完整堆栈信息，比如类找不到、反序列化异常等，根据堆栈信息精准修复

内容的提问来源于stack exchange，提问作者Megha Verma