必须使用kotlin-spring插件而非all-open，因其专为Spring优化：自动识别@Component等核心注解、处理@Autowired构造函数标记为primary；而all-open需手动配置易出错，且不支持构造注入语义。
直接在 build.gradle.kts 里启用 kotlin("plugin.spring") 就行，不需要额外声明注解或配置类，它会自动识别 Spring 核心注解并为对应类加 open。
为什么必须用 kotlin-spring 而不是 all-open
因为 kotlin-spring 是专为 Spring 场景优化的预设插件：它内置了对 @Component、@Service、@Repository、@Controller、@Configuration、@RestController 等常见注解的识别规则，无需手动列出来；而 all-open 需要你显式写 annotation("org.springframework.stereotype.Service")，容易漏、易配错、还可能误开非 Spring 类。
更关键的是：kotlin-spring 还会处理构造函数注入场景——比如把 @Autowired 构造函数标记为 primary，这对 Kotlin 的主构造函数语义很关键；all-open 不管这个。
Gradle Kotlin DSL 中的正确写法
确保插件声明顺序合理，且版本与 Kotlin 编译器一致：
plugins {
kotlin("jvm") version "1.9.24"
kotlin("plugin.spring") version "1.9.24" // 必须和 kotlin("jvm") 版本完全一致
id("org.springframework.boot") version "3.3.5"
id("io.spring.dependency-management") version "1.1.6"
}
注意两点：
-
kotlin("plugin.spring")必须出现在org.springframework.boot之前，否则某些 Gradle 生命周期钩子可能失效 - 不要在
dependencies块里再加org.jetbrains.kotlin:kotlin-allopen，它和kotlin-spring冲突，会导致编译报错Multiple plugins with the same ID
不生效的典型表现和排查点
写了插件但类还是 final，运行时报 java.lang.IllegalArgumentException: Class is not public 或 AOP 代理失败，常见原因有：
- 类没被 Spring 注解标注（比如只写了
class MyService，但没加@Service） - 注解来自错误包（比如用了
jakarta.annotation.Service而不是org.springframework.stereotype.Service） - 类在
src/test/kotlin下——kotlin-spring默认只处理main源集，测试代码需单独配kotlin("plugin.spring")到 test 任务（极少需要） - 用了 Lombok 的
@RequiredArgsConstructor但没关掉lombok.anyConstructor.addConstructorProperties，和 Spring 构造注入冲突
最常被忽略的一点：插件只影响字节码生成，不改变 Kotlin 源码语义。你在 IDE 里 Ctrl+Click 进去看到的仍是 final class，这是正常的——得看编译后的 .class 文件反编译结果，或者运行时用 MyClass::class.java.isInterface 和 MyClass::class.java.isSynthetic 辅助判断。别只信编辑器高亮。
