@Service注解在实现类中失效，Autowired注入失败问题求助

错误信息 #

'sample.RegistrationService' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}

现有代码与目录结构 #

接口代码（存在语法错误） #

public interface registration service

实现类代码 #

@Service
public class RegistrationServiceImpl implements RegistrationService{

    @Autowired
    RegistrationService registrationService;
}      

控制器类代码片段 #

@Autowired
private RegistrationService registrationService;

目录结构 #

• 服务类目录：Sample.service.Registration
• 控制器类目录：Sample.controller.registrationController

问题原因分析 #

1. 接口定义语法错误：接口名称不符合Java大驼峰命名规范，且缺少代码结构大括号，Spring无法识别合法的接口类型，导致依赖注入时找不到匹配的Bean类型。
2. 组件扫描范围未覆盖服务类：Spring默认扫描启动类所在包及其子包，若启动类不在Sample包下且未显式配置扫描范围，@Service标注的RegistrationServiceImpl不会被Spring容器管理。
3. 实现类内部循环依赖：RegistrationServiceImpl自身注入RegistrationService，属于无意义的循环依赖，会干扰Spring的Bean创建逻辑。
4. 包名/类名大小写不一致：错误信息中显示的sample.RegistrationService与目录Sample.service.Registration大小写不匹配，Java是大小写敏感语言，这会导致Spring无法定位到目标类。

解决步骤 #

1. 修正接口定义 #

按照Java语法规范调整接口，保证类名合规且结构完整：

public interface RegistrationService {
    // 按需定义接口方法
}

2. 移除实现类内部无效注入 #

删除实现类中自注入的代码，避免循环依赖：

@Service
public class RegistrationServiceImpl implements RegistrationService{
    // 实现接口方法
}      

3. 确保Spring组件扫描范围正确 #

• 若为Spring Boot项目，将启动类放在Sample包下（如Sample.Application），Spring会自动扫描该包下所有子包。
• 若启动类不在Sample包下，在启动类上添加@ComponentScan指定扫描范围：

@SpringBootApplication
@ComponentScan(basePackages = "Sample")
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

4. 统一包名与类名大小写 #

遵循Java规范统一命名：包名全小写（如将Sample.service.Registration改为sample.service.registration），类名保持大驼峰（RegistrationService、RegistrationServiceImpl），避免大小写不匹配问题。

5. 验证Bean注册状态 #

可在启动类中添加代码确认Bean是否被正确注册：

@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        ApplicationContext context = SpringApplication.run(Application.class, args);
        boolean hasBean = context.containsBean("registrationServiceImpl");
        System.out.println("RegistrationService Bean是否存在：" + hasBean);
    }
}

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