解决：Spring启动时注入失败

最新推荐文章于 2025-06-07 21:33:18 发布

原创最新推荐文章于 2025-06-07 21:33:18 发布 · 2.3k 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#spring #java #spring boot #bug #异常

异常专栏收录该内容

4 篇文章

订阅专栏

当Spring启动时，自动装配组件可能导致类名冲突，尤其是自定义类与第三方库类名相同。解决方法包括：为类指定名称注入，使用@Primary设定主要Bean，通过@SpringBootApplication exclude属性排除特定类，允许bean定义覆盖，检查并避免重复的Jar包引入。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在Spring启动时会帮我们自动装配一些组件，依赖注入，此时如果项目中自己定义的类名有相同的，或者自己定义的类名与引入的第三方包有相同的，就会引发冲突，原因是Spring在帮我们管理这些Bean时不知道使用的到底是哪一个，就会在启动时报错

常见异常：

Caused by: org.springframework.context.annotation.ConflictingBeanDefinitionException

Action:
Consider renaming one of the beans or enabling overriding by setting

… …

解决

方式一：

注入时在类上指定名称，如：@Service(value = “testExcludeClass”)，再按名称进行注入

@Autowired
@Qualifier(name = "testExcludeClass")
private TestExcludeClass testExcludeClass;

@Resource(name = "testExcludeClass")
private TestExcludeClass testExcludeClass;

方式二：

在配置类的方法上使用@Bean和@Primary，指定优先使用该Bean注入，注意在主启动类配置@ComponentScan注解，指明扫描哪些包或类

@Configuration
public class Config {
    @Bean
    @Primary
    public DataSourceProxy dataSourceProxy(DruidDataSource dataSource) {
        return new DataSourceProxy(dataSource);
    }
}

// 扫描包
@ComponentScan(basePackages = {"com.bwone.demo"})
// 扫描类
@ComponentScan(basePackageClasses= {com.bwone.demo.Config.class})

方式三：

在主启动类的@SpringBootApplication注解上使用exclude属性，指明启动时自动装配排除哪些包或类

@SpringBootApplication(exclude = "com.bwone.demo.TestExcludeClass")

方式四：

YML配置文件设置属性

spring:
  # 后发现的bean会覆盖先发现的bean
  main:
    allow-bean-definition-overriding: true

方式五：

可能由于Jar包冲突导致，检查是否引入相同的Jar包