Spring Boot 2.7.12升级3.3.3后EntitySpecRepository Bean创建失败求助

问题背景 #

将Spring Boot从2.7.12升级到3.3.3版本后，出现Bean创建失败问题，升级前代码运行完全正常。所有相关类均位于basePackages指定的com.xyz.abc包或其子包下。

相关代码结构 #

1. 顶层接口：

@Service
public interface EntitySpecRepository {
     ...
}

2. 条件化实现类：

@Service
@ConditionalOnProperty(value = "am.search.els.enabled", havingValue = "true")
@DependsOn(value = {"elasticIndexUtility"})
public class ElsEntitySpecRepositoryImpl extends EntitySpecRepositoryImpl {
     ...
}

3. 命名实现类：

@Service("entitySpecRepoRestClient")
public class EntitySpecRepoRestClient implements EntitySpecRepository {
     ...
}

4. 抽象基类：

public abstract class EntitySpecRepositoryImpl extends EntitySpecRepositoryHelper implements
        ImpactedEntitySpecRepository {
       .... 
}

5. 扩展接口：

public interface ImpactedEntitySpecRepository extends EntitySpecRepository {
      ....
}

6. 具体实现类：

public class ImpactedEntitySpecRepositoryImpl extends EntitySpecRepositoryImpl {}

错误信息 #

注入时抛出如下异常：

Field entitySpecRepository in com.xyz.abc.spec.service.ProductSpecReloadService required
a bean of type 'com.xyz.abc.sdk.repo.EntitySpecRepository' that could not be found.

注入点注解详情：

- @org.springframework.beans.factory.annotation.Autowired(required=true)

注入代码（位于ProductSpecRepository类中）：

@Autowired
private EntitySpecRepository entitySpecRepository;

已确认basePackage目录未发生变化，按预期应能正常创建Bean。

排查与解决思路 #

1. 移除接口上的@Service注解 #

Spring Boot 3.x（基于Spring Framework 6.x）对组件扫描逻辑做了严格调整：接口本身无法被实例化，标注@Service只会导致扫描逻辑混乱。仅在实现类上保留@Service或其他组件注解，删除EntitySpecRepository接口上的@Service。

2. 验证条件化Bean的生效状态 #

• 检查配置文件中am.search.els.enabled属性是否设置为true，若为false或未配置，ElsEntitySpecRepositoryImpl不会被创建。
• 确认elasticIndexUtility Bean是否正常创建，@DependsOn依赖的Bean失败会导致当前Bean无法初始化。

3. 明确指定注入的Bean名称 #

EntitySpecRepoRestClient被命名为entitySpecRepoRestClient，若存在多个EntitySpecRepository类型的Bean，需通过@Qualifier指定目标Bean：

@Autowired
@Qualifier("entitySpecRepoRestClient")
private EntitySpecRepository entitySpecRepository;

4. 为具体实现类添加组件注解 #

ImpactedEntitySpecRepositoryImpl是具体实现类，但未标注@Service等组件注解，Spring无法自动扫描它为Bean。若需使用该类，添加@Service注解。

5. 显式指定组件扫描范围 #

在启动类上明确声明扫描路径，避免Spring Boot 3.x的扫描规则变化导致遗漏：

@SpringBootApplication(scanBasePackages = "com.xyz.abc")
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

6. 检查依赖兼容性 #

确保项目中所有依赖（如Spring Data、Spring Security等）均升级到兼容Spring Boot 3.x的版本，依赖版本不兼容可能引发Bean注册异常。

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