all-open插件必须在Kotlin编译阶段启用，因为它是在kotlinc将.kt源码编译为JVM字节码前，扫描注解并自动为类和成员添加open修饰符的编译器插件；若仅引入依赖而未启用，Spring等框架的代理会因类仍为final而失败。
all-open插件为什么必须配在 Kotlin 编译阶段
它不是运行时或打包期的工具，而是 Kotlin 编译器插件——在 kotlinc 把 .kt 源码编译成 JVM 字节码前，就扫描注解、自动给类和成员加 open 修饰符。如果只加依赖不启用插件，Spring 的 @Service 类仍是 final，AOP 代理失败，报错类似 Cannot subclass final class。
Gradle Kotlin DSL（build.gradle.kts）中正确启用方式
用 plugins 块声明比旧式 buildscript 更可靠，避免 classpath 冲突：
plugins {
kotlin("jvm") version "1.9.20"
kotlin("plugin.spring") version "1.9.20" // 推荐直接用这个，已内置 all-open 规则
// 或者手动启用 all-open 插件：
// id("org.jetbrains.kotlin.plugin.allopen") version "1.9.20"
}
allOpen {
annotation("org.springframework.stereotype.Service")
annotation("org.springframework.stereotype.Controller")
annotation("org.springframework.stereotype.Repository")
annotation("org.springframework.context.annotation.Configuration")
}
-
kotlin("plugin.spring")是官方封装版，等价于all-open+ 预置 Spring 注解列表，更省心 - 手动用
id("org.jetbrains.kotlin.plugin.allopen")时，allOpen块必须写在 plugins 块之后，且不能放在configure等闭包里 - 注解字符串必须是完整类名，比如
"javax.persistence.Entity"，不能漏掉javax.或写成简写
常见踩坑点：注解没生效的三个原因
即使配置看起来没错，类仍被生成为 final，大概率是以下其一：
- 注解写在了接口上（如
@Service interface MyService）——all-open只处理类，不处理接口 - 用了元注解但没把元注解本身加进
allOpen { annotation(...) }列表（例如自定义了@MyService标记@Service，却只加了@Service） - 类继承了未被 open 的父类，而父类没带 any of the annotated annotations —— 插件不会递归打开整个继承链，只开直接标注或其超类中标注了指定注解的类
验证是否生效最简单的方法
写个最简测试类，反编译看字节码：
@Service
class MyService {
fun doWork() = "done"
}
执行 ./gradlew clean compileKotlin 后，用 IDE 打开编译输出目录下的 MyService.class，搜索 public class MyService —— 如果前面有 open 关键字（或字节码里有 ACC_PUBLIC + ACC_SUPER 但无 ACC_FINAL），说明成功；如果显示 final class MyService，说明插件未触发或注解不匹配。
注意：IDE 缓存常导致误判，务必清空 build/ 和 .gradle/ 下的缓存再重试。
