Java Spring Boot无法发现Kotlin组件，如何配置自动装配？

核心原因 #

SpringBoot的@SpringBootApplication默认从主类所在包开始扫描组件，但如果Kotlin源码的编译产物未被正确纳入classpath，或是扫描范围未明确覆盖（即便包名一致，也可能因构建配置问题导致Spring无法识别Kotlin类），就会出现仅扫描Java组件的情况。

可行解决方案 #

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

在主类上，通过@SpringBootApplication的scanBasePackages或scanBasePackageClasses参数，明确指定扫描范围，确保包含Kotlin组件所在的包：

@SpringBootApplication(scanBasePackages = "com.your.project.package")
@EnableJPARepositories
public class YourJavaMainClass {
    public static void main(String[] args) {
        SpringApplication.run(YourJavaMainClass.class, args);
    }
}

或者用scanBasePackageClasses直接指定一个Kotlin组件类，更具类型安全性：

@SpringBootApplication(scanBasePackageClasses = {YourJavaMainClass.class, YourKotlinController.class})
@EnableJPARepositories
public class YourJavaMainClass {
    // ...
}

2. 检查构建工具的Kotlin配置 #

确保Maven/Gradle正确配置了Kotlin编译插件，保证Kotlin源码被编译并加入classpath：

• Gradle：在build.gradle中加入Kotlin Spring插件，同时配置源码目录：

plugins {
    id 'org.springframework.boot' version 'x.x.x'
    id 'io.spring.dependency-management' version 'x.x.x'
    id 'org.jetbrains.kotlin.jvm' version 'x.x.x'
    id 'org.jetbrains.kotlin.plugin.spring' version 'x.x.x' // 关键插件，支持Spring注解的Kotlin类
}

sourceSets {
    main {
        kotlin { srcDirs = ['src/main/kotlin', 'src/main/java'] } // 同时包含Java和Kotlin源码目录
    }
}

• Maven：在pom.xml中配置Kotlin编译插件及allopen扩展：

<build>
    <plugins>
        <plugin>
            <groupId>org.jetbrains.kotlin</groupId>
            <artifactId>kotlin-maven-plugin</artifactId>
            <version>x.x.x</version>
            <executions>
                <execution>
                    <id>compile</id>
                    <phase>compile</phase>
                    <goals>
                        <goal>compile</goal>
                    </goals>
                    <configuration>
                        <sourceDirs>
                            <sourceDir>${project.basedir}/src/main/kotlin</sourceDir>
                            <sourceDir>${project.basedir}/src/main/java</sourceDir>
                        </sourceDirs>
                    </configuration>
                </execution>
            </executions>
            <dependencies>
                <dependency>
                    <groupId>org.jetbrains.kotlin</groupId>
                    <artifactId>kotlin-maven-allopen</artifactId>
                    <version>x.x.x</version>
                </dependency>
            </dependencies>
        </plugin>
    </plugins>
</build>

注：kotlin-maven-allopen插件会让标注Spring注解（如@RestController）的Kotlin类自动开放类和方法，满足Spring代理的要求。

3. 确认Kotlin类的Spring注解正确 #

确保Kotlin控制器、服务类等都标注了正确的Spring组件注解，比如@RestController、@Service、@Component、@Repository等，无注解的类Spring不会自动扫描注册。

验证方法 #

启动项目后，可通过Spring Boot Actuator的/beans端点（若启用），或在代码中注入ApplicationContext打印所有已注册Bean，确认Kotlin组件是否被纳入。

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