springboot注解不好使

### Spring Boot 中注解不生效的解决方案

#### 启动类配置不当
当 `@SpringBootApplication` 启动类缺少特定注解时，可能会导致某些功能无法正常工作。例如，对于异步方法的支持，启动类应当添加 `@EnableAsync` 注解来启用异步执行支持[^1]。

@SpringBootApplication
@EnableAsync
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

#### 返回值类型不符合规定
使用 `@Async` 或其他依赖于 AOP 的注解时，需注意其返回类型的限定。特别是 `@Async` 方法应仅返回 `void` 或者 `Future<?>` 类型的数据，以确保能够被正确处理。

#### 动态代理机制未触发
由于 `@Transactional`, `@Async` 等注解的功能实现依赖于 Spring AOP 提供的动态代理技术，因此如果目标对象不是由 Spring 容器创建，则这些注解可能不会起作用。这通常发生在直接实例化 Bean 而非通过注入方式获取的情况下。为了使此类注解有效，应该让组件成为 Spring 上下文中的一部分，并经由上下文管理其实例生命周期。

#### Filter 配置错误
在 Spring Boot 应用程序中定义过滤器 (Filter)，仅仅依靠标准 Servlet API (`javax.servlet.Filter`) 及相应标注（如 `@WebFilter`），并不能保证自定义行为被执行；相反地，开发者需要借助 Spring 自身提供的工具集——比如编写专门用于注册 Filters 的 Configuration Class 来完成这项任务。这样做可以避免因默认设置而导致所有请求都被拦截的问题发生[^3]。

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Bean
    public MyCustomFilter myCustomFilter() {
        return new MyCustomFilter();
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // Add custom interceptors here...
    }
}

#### 参数校验失败
针对表单验证场景下的 `@Validated` 注解不起效的情况，除了确认所使用的 Spring 版本外，还需仔细审查模型字段上的约束条件声明是否准确无误以及是否存在复杂的嵌套结构影响到最终的效果呈现。另外，在控制器层面上接收参数的地方记得要加上相应的 BindingResult 对象以便捕获潜在异常信息[^4]。

@PostMapping("/submit")
public ResponseEntity<String> submitForm(@Validated @RequestBody FormData formData,
                                         BindingResult bindingResult) throws Exception {
    if (bindingResult.hasErrors()) {
        throw new ValidationException(bindingResult.getAllErrors());
    }
    service.process(formData);
    return ResponseEntity.ok("Success");
}

#### 组件扫描范围不足
最后一种常见情形涉及到了 `@Controller` 这样的 MVC 控制器标记符未能按预期运作的情形。此时应回顾应用程序的整体布局设计图谱，确保所有的 Controller 均位于根包及其子包之内，从而允许自动化的 Component Scanning 流程顺利找到它们并纳入托管体系之中[^5]。