Kotlin自定义注解数组参数构造报错：期望Role[]的类型注解

嘿，我之前也踩过这个坑！这其实是Kotlin和Java在注解数组参数语法上的差异导致的，别慌，咱们一步步来解决。

你看到的"期望在Role[]上添加类型注解"错误，核心原因是Kotlin不支持用Java风格的Type[]语法声明注解参数类型，必须改用Kotlin原生的数组类型语法Array<Type>。

错误写法示例（你当前可能的代码） #

// 这种Java风格的数组声明在Kotlin注解里会报错
annotation class RequiresRoles(val roles: Role[])

正确的注解定义方式 #

假设Role是你定义的枚举类，正确的自定义注解应该这么写：

// 先定义你的Role枚举
enum class Role { ADMIN, MODERATOR, USER }

// 用Kotlin的Array<Role>声明数组参数
annotation class RequiresRoles(val roles: Array<Role>)

如何使用这个注解 #

在使用注解时，Kotlin提供了简化的数组初始化语法，直接用[]包裹元素即可：

// 传入多个角色权限
@RequiresRoles([Role.ADMIN, Role.MODERATOR])
fun deleteSystemConfig() {
    // 你的业务逻辑代码
}

// 传入单个角色权限
@RequiresRoles([Role.USER])
fun viewUserProfile() {
    // 你的业务逻辑代码
}

额外小提示 #

如果你的数组参数是基本类型（比如Int、Boolean），推荐使用Kotlin的原生数组类型（IntArray、BooleanArray等），而非Array<Int>，这样能避免装箱带来的性能开销：

annotation class ResourcePermissions(val allowedIds: IntArray)

// 使用示例
@ResourcePermissions([1001, 1002, 1003])
fun accessPrivateResource() {}

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