Eclipse中Maven+Spring项目无法识别@RequestMapping注解的问题

我来给你梳理下这个问题的常见解决方法，我在Eclipse里搭建Spring MVC项目时也碰到过好几次这个情况，一步步来排查：

1. 检查注解的导入包是否正确 #

首先确认你代码里导入的@RequestMapping是不是来自正确的包：

import org.springframework.web.bind.annotation.RequestMapping;

别不小心导入了其他无关的包（比如某些第三方框架的同名注解），如果导错了，删掉当前导入语句，重新导入上面这个正确的包。

2. 确认Maven依赖是否完整加载 #

• 先看项目的Maven Dependencies目录下，有没有spring-webmvc-5.0.4.RELEASE.jar和它依赖的spring-web-5.0.4.RELEASE.jar。如果缺失，右键项目 → Maven → Update Project，勾选「Force Update of Snapshots/Releases」，让Maven强制重新下载依赖。网络波动或者镜像问题经常会导致依赖下载不全，强制更新大多能解决。
• 如果更新后还是没有spring-web，可以手动在pom.xml里添加这个依赖（虽然spring-webmvc会自动依赖它，但偶尔会有Maven解析异常）：

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-web</artifactId>
    <version>5.0.4.RELEASE</version>
</dependency>

3. 确保项目是正确的Dynamic Web Project #

如果你的项目是从普通Maven项目转成Web项目的，可能配置不全：
右键项目 → Properties → Project Facets，检查「Dynamic Web Module」是否已勾选，版本建议选3.0及以上（和Spring 5.x版本兼容）。如果没勾选，勾选后点击Apply，必要时生成web.xml文件。

4. 清理Eclipse缓存与重新编译 #

有时候Eclipse的编译缓存会导致注解识别异常：

• 右键项目 → Clean，清理编译文件后重新Build；
• 或者执行顶部菜单 Project → Clean → Clean all projects，之后重启Eclipse试试。

5. 确认Controller类被Spring管理 #

@RequestMapping只有在被Spring MVC容器管理的类上才会生效，所以你的Controller类必须加上@Controller或者@RestController注解，比如：

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class MyController {
    @RequestMapping("/hello")
    public String hello() {
        return "hello";
    }
}

如果类上没加这些注解，IDE可能会提示注解无法识别，运行时也不会生效。

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