Spring Web项目部署Tomcat后访问REST接口返回404错误如何解决

解决方案 #

1. 修正DispatcherServlet映射规则

你当前配置的/*会让DispatcherServlet拦截所有请求（包括Tomcat默认Servlet处理的资源、错误页面等），导致路径匹配异常，修改WebInitializer中的映射配置：

@Override
protected String[] getServletMappings() {
    // 替换原有 /* 配置
    return new String[]{"/"};
}

2. 核对Tomcat应用上下文与访问路径

你之前尝试在@RequestMapping中添加应用名前缀的做法是错误的，应用上下文是Tomcat部署阶段的配置，不需要写入业务代码的路径规则：

• 打开IDEA的Tomcat运行/调试配置，切换到「Deployment」标签
• 找到当前部署的工程对应的「Application context」配置项：
  • 若配置为/，则你的接口完整访问路径为 http://localhost:8080/blog/api/living
  • 若配置为/自定义前缀（比如/myblog），则完整访问路径为 http://localhost:8080/自定义前缀/blog/api/living

3. 检查JSON序列化依赖

@RestController自动序列化Java对象为JSON需要依赖Jackson组件，确认你的构建配置中已添加对应依赖，Maven配置示例如下：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

4. 验证包扫描与启动日志

• 确认你的MyRESTController类处于com.dashkindima.blog.mvc包或其子包下，否则会被@ComponentScan规则排除，无法注册到Spring容器中。
• 启动Tomcat时查看控制台日志，若出现Mapped "{[/blog/api/living],methods=[GET]}"类的输出则说明接口已成功注册，问题出在访问路径填写错误；若没有对应日志则说明Controller未被正常扫描，可核对包路径和注解配置。

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