Spring Boot应用初始化失败：personDAO Bean名称冲突求助

错误信息 #

注解指定的Bean名称personDAO（对应类com.gmail.tihamer.rozman.demo.PersonDAO）与已存在的、不兼容的同名Bean定义冲突，该Bean对应类为org.springframework.data.jpa.repository.support.JpaRepositoryFactoryBean

问题背景 #

正在复刻Spring的MySQL数据访问教程，已创建对应实体类（POJO）和Repository接口，但未找到重复定义Bean的位置。

相关代码 #

实体类 #

package com.gmail.tihamer.rozman.demo;

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;
import lombok.AllArgsConstructor;
import lombok.Getter;
import lombok.NoArgsConstructor;
import lombok.Setter;

@NoArgsConstructor
@AllArgsConstructor
@Getter
@Setter
@Entity
public class Person {
    @Id
    @GeneratedValue(strategy= GenerationType.AUTO)
    private int id;
    private String name;
}

Repository接口 #

package com.gmail.tihamer.rozman.demo;

import org.springframework.data.repository.CrudRepository;

// Spring会自动将该接口实现为名为userRepository的Bean
// CRUD对应创建、读取、更新、删除操作

public interface PersonDAO extends CrudRepository<Person, Integer> {

}

解决方案 #

这个冲突是因为Spring Data JPA自动生成Repository实现Bean时，与你定义的PersonDAO接口产生了名称冲突，可通过以下方式解决：

• 修改接口名称为PersonRepository，遵循Spring Data JPA的常规命名规范，既能避免冲突，也更符合行业惯例。
• 在接口上添加@Repository("自定义Bean名称")注解，比如@Repository("personRepo")，强制指定Bean名称，避免重名。
• 检查Spring配置类的组件扫描范围，确认没有重复扫描同一个包路径导致Bean重复注册。

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