《Spring编程常见错误50例》读书笔记

源码构建依赖下载可能遇到的问题：

https://blog.csdn.net/xiangxiaotian666/article/details/127399904

Spring Core

工厂 BeanFactory 内部有 Map
Scan 负责扫描需要实例化的 Bean
最终使用反射的方式实例化：
1. java.lang.Class.newInsance();
2. java.lang.reflect.Constructor.newInstance();
3. ReflectionFactory.newConstructorForSerialization();
AOP 使用多态代理实现，需要代理哪些类就使用 @Aspect 中定义的切点来表示

Bean 定义

隐式扫描不到 Bean 的定义

:::color4
定义的类没有写到 Application 同级或者下级目录的时候就找不到 Bean 定义

:::

解决

可以在 Application 上写上：

@ComponentScans(value = { @ComponentScan(value ="com.spring.puzzle.class1.example1.controller") })-
@ComponentScan可以多个同时使用，且都生效。效果等同于@ComponentScans
@SpringBootApplication(scanBasePackages = {"com.xxx.xxxxx","com.xxx.xxx"})

原理

@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
@Documented
@Inherited
@SpringBootConfiguration
@EnableAutoConfiguration
@ComponentScan(excludeFilters = { 
    @Filter(type = FilterType.CUSTOM, classes = TypeExcludeFilter.class),
    @Filter(type = FilterType.CUSTOM, classes = AutoConfigurationExcludeFilter.class) })
public @interface SpringBootApplication {
//省略非关键代码
}

Spring 默认规则：ComponentScan 注解的 basePackages 属性指定扫描哪些 Bean 定义。没有指定，默认为空（即{}）。此时解析启动类（配置类）的时候，就会为其填充默认值：

定义的 Bean 缺少隐式依赖

:::color4
自定义了构造器，但是没有将构造器的入参注入到 spring，导致 spring 使用对应的构造器实例化 Bean 时候找不到参数而失败

:::

@Service
public class ServiceImpl {
    private String serviceName;
    public ServiceImpl(String serviceName){
        this.serviceName = serviceName;
    }
}

解决

定义一个Bean，名字就是 serviceName，这个bean装配给ServiceImpl的构造器参数“serviceName”

@Bean
public String serviceName(){
    return "MyServiceName";
}

原理

我们定义一个类为 Spring Bean A，如果再显式定义了构造器，那么这个 Bean A 在构建时，会自动根据构造器参数定义寻找对应类型的 Bean B，然后反射创建出这个 Bean B 作为 A 构造器的入参去反射创建 Bean A。

自定义多个构造器没有指定优先级

存在两个构造器，都可以调用时，最终 Spring 无从选择，只能尝试去调用默认构造器，而这个默认构造器又不存在，所以测试这个程序它会出错。

@Service
public class ServiceImpl {
    private String serviceName;
    public ServiceImpl(String serviceName){
        this.serviceName = serviceName;
    }
    public ServiceImpl(String serviceName, String otherStringParameter){
        this.serviceName = serviceName;
    }
}

原型Bean不能如你所愿每次都创建

:::color4
定义了一个原型的 Bean A，在另外一个 Bean B 中使用 @Autowired 注入之后，希望每次调用都是一个新的对象，但是其实是同一个对象。因为 Bean B 其实只实例化了一次，A 作为被依赖方只有在 B 实例化的时候被调用

:::

@Service
@Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
public class ServiceImpl {
}

@RestController
public class HelloWorldController {

    @Autowired
    private ServiceImpl serviceImpl;

    @RequestMapping(path = "hi", method = RequestMethod.GET)
    public String hi(){
         return "helloworld, service is : " + serviceImpl;
    };
}

访问多少次，结果都是一样的

解决

不能将 ServiceImpl 的 Bean 固定到属性上的，而应该是每次使用时都会重新获取一次。

方式一：每次从 ApplicationContext 中获取

@RestController
public class HelloWorldController {
    @Autowired
    private ApplicationContext applicationContext;

    @RequestMapping(path = "hi", method = RequestMethod.GET)
    public String hi(){
        return "helloworld, service is : " + getServiceImpl();
    };

    public ServiceImpl getServiceImpl(){
        return applicationContext.getBean(ServiceImpl.class);
    }
}

方式二：使用 `@Lookup`

@RestController
public class HelloWorldController {
 
    @RequestMapping(path = "hi", method = RequestMethod.GET)
    public String hi(){
        return "helloworld, service is : " + getServiceImpl();
    };

    @Lookup
    public ServiceImpl getServiceImpl(){
        return null;
    }
}

https://blog.csdn.net/qq_25863845/article/details/123475147

标记了 Lookup 的方法最终走入了CGLIB 搞出的类 CglibSubclassingInstantiationStrategy.LookupOverrideMethodInterceptor，这个方法的关键实现参考 LookupOverrideMethodInterceptor#intercept。方法调用最终并没有走入案例代码实现的return null语句，而是通过 BeanFactory 来获取 Bean。其实 **getServiceImpl** 方法实现中，随便怎么写都行。

为什么会使用cgLib？是因为在初始化实例的时候（参考 SimpleInstantiationStrategy#instantiate），会发现有方法标记了 Lookup，此时就会添加相应方法到属性methodOverrides 里面去（此过程由 AutowiredAnnotationBeanPostProcessor#determineCandidateConstructors 完成），Lookup 会重写方法。也就是说方法内部的实现，在Bean被实例化的时候就被替换成 CGLIB 的实现了。

@Override
public Object instantiate(RootBeanDefinition bd, @Nullable String beanName, BeanFactory owner) {
    // 当 hasMethodOverrides 为 true 时，则使用 CGLIB。
    if (!bd.hasMethodOverrides()) {
        //
        return BeanUtils.instantiateClass(constructorToUse);
    }
    else {
        // Must generate CGLIB subclass.
        return instantiateWithMethodInjection(bd, beanName, owner);
    }
}

原理

找到要自动注入的 Bean 后，通过反射设置给对应的field。这个field的执行只发生了一次，所以后续就固定起来了，并不会因为 ServiceImpl 标记了 SCOPE_PROTOTYPE 而改变。所以我们请求多少次都不会重新去Spring容器获取 ServiceImpl，而是直接获取 Controller 引用的那个对象。

注入

required a single bean, but 2 were found

:::danger
@Autowired 的一个接口有多个实现的时候，就无法工作了

:::

@RestController
@Slf4j
@Validated
public class StudentController {
    @Autowired
    DataService dataService;

    @RequestMapping(path = "students/{id}", method = RequestMethod.DELETE)
    public void deleteStudent(@PathVariable("id") @Range(min = 1,max = 100) int id){
        dataService.deleteStudent(id);
    };
}

public interface DataService {
    void deleteStudent(int id);
}

@Repository
@Slf4j
public class OracleDataService implements DataService{
    @Override
    public void deleteStudent(int id) {
        log.info("delete student info maintained by oracle");
    }
}

@Repository
@Slf4j
public class CassandraDataService implements DataService{
    @Override
    public void deleteStudent(int id) {
        log.info("delete student info maintained by cassandra");
    }
}

解决

让候选实现类具有优先级或压根可以不去选择。

方式一：设置优先级

@Repository
@Primary
@Slf4j
public class OracleDataService implements DataService{
    //省略非关键代码
}

方式二：指定精确 Bean名字

将属性名和Bean名字精确匹配，这样就可以让注入选择不犯难

1 2	@Autowired DataService oracleDataService;

方式三：使用 @Qualifier 显式指定使用哪种

1
2
3

@Autowired()
@Qualifier("cassandraDataService")
DataService dataService;

方式四：使用策略模式存到自己定义的 map 中

自己定义一个策略类，实现 InitializingBean

文章作者: 褚成志

文章链接: https://www.chucz.asia/2026/04/09/Spring%E8%B8%A9%E5%9D%91%E4%B8%80/

Spring 踩坑

相关推荐

2026-04-09

Spring踩坑二

Spring Webhttp 请求处理流程总览1234567@RestController public class HelloWorldController { @RequestMapping(path = "hi", method = RequestMethod.GET) public String hi(){ return "helloworld"; }; } 请求的 Path: hi 请求的方法：Get 对应方法的执行：hi() 那么，假设让你自己去实现 HTTP 的请求处理，你可能会写出这样一段伪代码： 1234567891011public class HttpRequestHandler{ Map<RequestKey, Method> mapper = new HashMap<>(); public Object handle(HttpRequest http...

2026-04-09

Spring

指定 DAO接口放置的包 com.baizhiedu.dao 123456789+ 编码 ```markdown# 实战经常根据需求写的代码1. 实体2. 表3. 创建DAO接口4. 实现Mapper文件 5. Spring与Mybatis整合编码搭建开发环境(jar) 1234567891011121314151617181920212223242526272829<dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>5.1.14.RELEASE</version></dependency><dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis...

2026-04-09

SpringDataElasticsearch聚合实现过滤搜索

过滤功能分析整个过滤部分有3块：顶部的导航，已经选择的过滤条件展示：商品分类面包屑其它已选择过滤参数过滤条件展示，又包含3部分商品分类展示品牌展示其它规格参数展开或收起的过滤条件的按钮顶部导航要展示的内容跟用户选择的过滤条件有关。这部分需要依赖第二部分：过滤条件的展示和选择。展开或收起的按钮是否显示，取决于过滤条件有多少，如果很少，那么就没必要展示。所以也是跟第二部分的过滤条件有关。先做第二部分：过滤条件展示。分类和品牌过滤条件获取和展示数据库中已经有所有的分类和品牌信息。无论是分类信息，还是品牌信息，都应该从搜索的结果商品中进行聚合得到。扩展返回的结果返回的结果PageResult对象，里面只有total、totalPage、items3个属性。现在要对商品分类和品牌进行聚合，添加分类和品牌的数据。分类：页面显示了分类名称，但背后肯定要保存id信息。所以至少要有id和name 品牌：页面展示的有logo，有文字，当然肯定有id，基本上是品牌的完整数据新建一个类，继承PageResult，然后扩展两个新的属性：分类集合和品牌集合： 123...

2026-04-09

Spring应用上下文的获取和保存Bean

Spring 容器是 IOC 容器，但是，反过来却不成立不常用的容器实现 – BeanFactory：最简单的容器，提供基本的 DI 功能高级实现，继承 BeanFactory 派生的应用上下文 – ApplicationContext：解析配置文件，创建、装配、管理、销毁 Bean 获取 ApplicationContext 的四种方式ApplicationContextInitializar：容器创建完成之后的回调定义在 org.springframework.context 包下 ApplicationListener：观察者模式的典型应用（常用） Spring Boot 启动程序的返回run 方法返回的就是应用上下文 ApplicationContextAware : Spring 的 Aware 接口（常用）Aware 可以理解为“察觉、注意到的、感知的”，在 Spring 中，XxxAware 也就是对 Xxx 感知的意思编写工具类：保存上下文，获取Bean

2026-04-09

时间格式不能正常转换？

@DateTimeFormat 注解前台到后台的时间格式转换，对于GET 请求参数可以正常工作。对于 POST 请求会报反序列化错误 POST 请求会使用 JSON 反序列化，不会使用 @DateTimeFormat 注解。 POST 表单（body）实现时间格式转换的方法使用 @JsonFormat 注解但是这种代码侵入性强，可维护性差实现自定义格式转换器 @JsonDeserialize可以支持多种时间格式的转换：指定反序列化器定义全局配置类避免冗余代码指定转换器做Date类型的反序列化：在对象中就不需要指定对应的注解了。

2026-04-09

SpringBoot定时任务不定时执行了

两个注解@EnableScheduling：使得@Scheduled生效 @Scheduled：标注在方法上 @Scheduled 注解fixedDelay任务结束与开始之间的间隔 fixedRate两次任务的开始的间隔，不管任务是不是执行结束 initialDelay：配合性的，可以和上面两个配合使用，第一次执行的延迟时间 cron：Linux 系统中定时任务的效果，更加灵活设置时间基本使用此时运行的时候，第二个任务其实是不会执行的原理如果不指定 scheduler ，就默认使用单线程的 scheduler，所以上面的就会阻塞，第二个定时任务拿不到线程配置定时任务的线程池配置文件中指定定时任务线程数 spring.task.scheduling.pool.size 自定义定时任务的线程池，编写 ScheduleConfig

Spring Core

Bean 定义

隐式扫描不到 Bean 的定义

解决

原理

定义的 Bean 缺少隐式依赖

解决

原理

自定义多个构造器没有指定优先级

原型Bean不能如你所愿每次都创建

解决

方式一：每次从 ApplicationContext 中获取

方式二： 使用 @Lookup

原理

注入

required a single bean, but 2 were found

解决

方式一：设置优先级

方式二：指定精确 Bean名字

方式三：使用 @Qualifier 显式指定使用哪种

方式四：使用策略模式存到自己定义的 map 中

方式二：使用 `@Lookup`