Kotlin字段注解：数组式与分散式声明的差异探究

在Kotlin中给字段声明多个注解时，以下两种写法存在明显差异，最终执行结果也不一致：

示例Kotlin代码 #

class Sample {
    @Inject
    @CustomInfo
    lateinit var fieldA: Any

    @field:[
        Inject
        CustomInfo
    ]
    lateinit var fieldB: Any
}

对应的注解定义 #

Kotlin限定符注解：

@Qualifier
@Retention(AnnotationRetention.RUNTIME)
annotation class CustomInfo

Java注入注解：

@Target({ METHOD, CONSTRUCTOR, FIELD })
@Retention(RUNTIME)
@Documented
public @interface Inject {}

反编译后的Java代码 #

public final class Sample {
   @Inject
   public Object fieldA;
   @Inject
   @CustomInfo
   public Object fieldB;

   /** @deprecated */
   // $FF: synthetic method
   @CustomInfo
   public static void getFieldA$annotations() {
   }
}

差异分析 #

1. 注解挂载目标不同

   • fieldA：@Inject直接标注在字段上，但@CustomInfo被Kotlin编译到自动生成的合成方法getFieldA$annotations()中，并未附加在字段本身。
   • fieldB：通过@field:注解目标指定器，@Inject和@CustomInfo都直接标注在字段上。

2. 执行表现差异
   依赖反射的框架（如Dagger等DI框架）只会识别字段上的注解，因此：

   • fieldA的@CustomInfo无法被框架识别为字段的限定符，注入过程可能无法匹配到对应依赖实例。
   • fieldB的两个注解都能被框架正确识别，注入逻辑可正常运行。

结论 #

这两种写法的输出完全不一致，执行时的表现也有差异。当需要给Kotlin字段添加注解时，必须通过@field:明确指定注解目标，才能确保注解被挂载到字段本身，被Java反射或相关框架正确识别。

内容的提问来源于stack exchange，提问作者Michał Dobi Dobrzański