Wicket REST功能在Jetty正常运行但Tomcat下报404错误求助

我之前也踩过Wicket REST在Tomcat下404的坑，结合你的描述，应该是这几个常见配置点出了问题，给你梳理下排查和解决的方向：

1. 确认REST资源的挂载路径是否正确 #

Wicket的REST资源必须在你的Wicket应用类（继承WebApplication的那个）里手动注册，而且要注意Tomcat的应用上下文路径会影响最终的访问URL。你需要确保应用初始化代码里有类似这样的注册逻辑：

@Override
protected void init() {
    super.init();
    // 注册REST资源，这里的"/webhook"是挂载的根路径
    mountResource("/webhook", new Webhook());
}

这里要注意两个关键点：

• 最终的POST请求URL应该是http://<tomcat地址>:<端口>/<应用上下文>/webhook/notification，比如你的应用部署在Tomcat的myapp上下文下，完整路径就是http://localhost:8080/myapp/webhook/notification
• 不要让REST资源的挂载路径和Wicket页面的路径冲突，比如如果已经挂载了/admin页面，就别把REST资源也挂在/admin下

2. 检查Tomcat的Filter映射配置 #

Wicket的请求都是通过WicketFilter处理的，如果你在web.xml里的Filter映射配置有问题，REST请求可能根本到不了Wicket的处理器。检查你的web.xml，确保WicketFilter的URL模式是/*，并且没有被其他Filter拦截：

<filter>
    <filter-name>wicket-yourAppName</filter-name>
    <filter-class>org.apache.wicket.protocol.http.WicketFilter</filter-class>
    <init-param>
        <param-name>applicationClassName</param-name>
        <param-value>com.your.package.YourWicketApplication</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>wicket-yourAppName</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

如果你的项目里还有其他Filter（比如安全校验Filter），要调整Filter的顺序，让WicketFilter优先处理REST路径的请求，或者配置其他Filter不要拦截你的REST路径。

3. 验证依赖包是否完整部署到Tomcat #

虽然你在POM里配置了wicketstuff-annotation、wicketstuff-restannotations、wicketstuff-restannotations-json，但要确保这些依赖包（包括它们的间接依赖，比如Jackson相关的JSON处理包）都被正确打包到WEB-INF/lib目录下。

可以做两个检查：

• 确认POM的打包类型是war：

  <packaging>war</packaging>
  

• 用Maven命令查看依赖树，确保没有版本冲突或者缺失：

  mvn dependency:tree | grep -E "(wicketstuff|jackson)"
  

如果有版本冲突，可能会导致JSON序列化组件无法正常初始化，间接引发404错误。

4. 检查REST方法的参数解析是否合法 #

你的notification方法用了@RequestBody注解，要确保对应的Notification类符合Jackson的序列化要求：

• 必须有无参构造函数（Jackson默认用无参构造创建实例）
• 所有需要解析的字段都有对应的getter和setter方法

比如正确的Notification类应该是这样的：

public class Notification {
    private String message;
    private Long timestamp;

    // 必须要有无参构造
    public Notification() {}

    // getter和setter
    public String getMessage() { return message; }
    public void setMessage(String message) { this.message = message; }
    public Long getTimestamp() { return timestamp; }
    public void setTimestamp(Long timestamp) { this.timestamp = timestamp; }
}

如果参数解析失败，有些情况下Tomcat会直接返回404而不是更准确的400错误，这点容易被忽略。

5. 开启调试日志定位请求流程 #

如果上面的方法都没解决问题，建议开启Wicket的DEBUG日志，看看请求到底有没有到达REST处理器。修改你的日志配置文件（比如log4j.properties）：

log4j.logger.org.apache.wicket=DEBUG
log4j.logger.org.wicketstuff.rest=DEBUG

然后查看Tomcat的catalina.out日志文件，你能看到请求的完整处理流程，比如路径匹配是否成功、REST资源是否被正确识别，这些日志会帮你快速定位问题所在。

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