Kotlin+Spring Boot2.5.4项目启动找不到UserRepository类型Bean报错求助

1. 核对Mapper扫描配置 #

• MyBatis场景：仅给Repository类加@Mapper注解无法被Spring自动识别，必须在启动类上添加@MapperScan注解，且指定的扫描路径包含UserRepository所在的包：

@SpringBootApplication
@MapperScan("com.yourproject.mapper") // 替换为UserRepository实际所在包路径，多包用逗号分隔
class DemoApplication
fun main(args: Array<String>) {
    runApplication<DemoApplication>(*args)
}

• Spring Data JPA场景：删除@Mapper注解，在启动类上添加@EnableJpaRepositories指定Repository扫描路径，同时给实体类添加@Entity注解，启动类追加@EntityScan扫描实体类所在包。

2. 核对Spring包扫描范围 #

Spring Boot默认仅扫描启动类所在包及其子包下的Bean，如果UserRepository不在该层级内，需要手动指定根包扫描路径：

@SpringBootApplication(scanBasePackages = ["com.yourproject"]) // 替换为项目根包路径
class DemoApplication

3. 核对Kotlin编译插件配置 #

Kotlin默认所有类都是final类型，Spring生成代理Bean需要类为非final，必须配置kotlin-allopen插件，Maven配置示例：

<plugin>
    <groupId>org.jetbrains.kotlin</groupId>
    <artifactId>kotlin-maven-plugin</artifactId>
    <version>${kotlin.version}</version>
    <configuration>
        <compilerPlugins>
            <plugin>spring</plugin>
            <plugin>jpa</plugin> <!-- JPA场景必须添加 -->
        </compilerPlugins>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-allopen</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
        <dependency>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-noarg</artifactId>
            <version>${kotlin.version}</version>
        </dependency>
    </dependencies>
</plugin>

4. 核对注解使用正确性 #

• MyBatis场景：无需添加@Repository注解，仅保留@Mapper+@MapperScan即可，部分版本同时添加两个注解会导致重复代理，触发Bean注册冲突。
• JPA场景：无需添加@Mapper、@Repository注解，只需让UserRepository继承JpaRepository<你的实体类, 主键类型>，Spring会自动生成实现类注册为Bean。

5. 核对依赖引入 #

确认pom.xml中已引入匹配Spring Boot 2.5.4版本的持久层starter，不要同时引入多个持久层框架starter：

• MyBatis场景：引入mybatis-spring-boot-starter
• JPA场景：引入spring-boot-starter-data-jpa

6. 核对注入写法 #

Kotlin优先使用构造器注入，避免字段注入的空安全问题和注解漏加问题，示例写法：

@Service
class UserServiceImpl(private val userRepository: UserRepository) : UserService {
    // 业务实现代码
}

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