如何让Spring忽略特定包中的@RequestMapping注解？

我太懂这种糟心的情况了——当你为了复用接口契约，把REST端点和Feign客户端共用一套抽象API时，Spring MVC会把Feign那边的@RequestMapping也当成自己的控制器端点来注册，平白无故多出一堆无效接口。别慌，这里有几个实用的解决办法：

方案1：通过@ComponentScan直接排除目标包的注解扫描 #

最直接的方式就是从Spring组件扫描的源头下手，让它忽略Feign客户端所在包下的@RequestMapping注解。你可以在Spring Boot的主启动类或者配置类上这么配置：

@SpringBootApplication
@ComponentScan(
    basePackages = "com.yourcompany",
    excludeFilters = {
        @ComponentScan.Filter(
            type = FilterType.ANNOTATION,
            value = RequestMapping.class,
            // 替换成你实际的Feign客户端所在包路径
            pattern = "com.yourcompany.feign.clients.*"
        )
    }
)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

这段配置会告诉Spring：扫描com.yourcompany下的组件，但跳过com.yourcompany.feign.clients包下所有带@RequestMapping的类，直接从扫描阶段就阻止Feign接口被当成REST端点注册。

方案2：用@ControllerScan精准过滤控制器扫描范围 #

如果你不想修改全局的@ComponentScan规则，可以单独给Spring MVC的控制器扫描加过滤条件，只扫描你的实际业务控制器包，排除Feign客户端：

首先，你的Feign客户端接口还是正常加@FeignClient和@RequestMapping：

@FeignClient(name = "user-service")
@RequestMapping("/api/users")
public interface UserClient {
    @GetMapping("/{id}")
    User getUserById(@PathVariable("id") Long id);
}

然后新建一个Web配置类，配置@ControllerScan的排除规则：

@Configuration
@ControllerScan(
    // 指定你的实际REST控制器所在包
    basePackages = "com.yourcompany.controllers",
    excludeFilters = @ComponentScan.Filter(
        type = FilterType.REGEX,
        // 排除Feign客户端所在包
        pattern = "com.yourcompany.feign.clients.*"
    )
)
public class WebMvcConfig {
}

这样Spring MVC只会专注扫描业务控制器，完全不会碰Feign客户端的接口。

方案3：拆分契约与实现（更优雅的长期方案） #

如果觉得上面的配置有点“治标不治本”，可以考虑把通用契约抽成独立模块，彻底分离框架注解和业务接口：

1. 新建一个独立的common-api模块，只放纯业务接口，不带任何框架注解：

public interface UserServiceContract {
    User getUserById(Long id);
}

2. 在REST控制器模块里，实现这个契约并添加Spring MVC的注解：

@RestController
@RequestMapping("/api/users")
public class UserController implements UserServiceContract {
    @Override
    @GetMapping("/{id}")
    public User getUserById(@PathVariable("id") Long id) {
        // 这里写你的业务逻辑
        return userRepository.findById(id).orElseThrow();
    }
}

3. 在Feign客户端模块里，继承契约并添加Feign的注解：

@FeignClient(name = "user-service")
@RequestMapping("/api/users")
public interface UserClient extends UserServiceContract {
    @Override
    @GetMapping("/{id}")
    User getUserById(@PathVariable("id") Long id);
}

这种方式从根源上避免了注解冲突，契约只定义业务行为，框架注解各自在实现类和客户端上添加，既保证了复用性，又不会让Spring MVC混淆识别。

小提示 #

配置完之后，你可以通过访问/actuator/mappings（如果开启了Actuator）来检查端点列表，确认Feign的接口没有被注册成REST端点，确保配置生效。

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