Gradle 4.10.2 构建时注解引用常量触发非常量表达式报错问题

Java语法明确要求，注解的入参必须是编译期可直接解析的常量表达式，不能是运行阶段才会加载求值的变量。你代码里的COL_NAME是类内直接定义的字面量常量，编译期就能确定值，所以不会触发报错，只有引用了DB.DataType.VARCHAR的COLTYPE_NAME会被判定为非常量表达式，结合你的代码，触发该报错的具体原因有两个：

• 你定义的DB.DataType.VARCHAR存在语法疏漏：原代码写为public static final VARCHAR = "varchar";，没有显式声明String类型，本身不符合Java编译规范，自然无法被识别为有效的编译期常量
• 即使补全了变量类型，Gradle 4.10.2作为较早的版本，在使用增量编译、注解处理器类隔离特性时，偶尔会出现跨类静态常量解析失效的问题，把本来符合规范的常量误判为非编译期值

1. 修正常量定义，完全满足编译期常量规范 #

先把DB类里的VARCHAR定义补全为符合要求的编译期常量，不要在赋值时使用方法调用、字符串拼接、配置读取等运行时操作：

public final class DB{
    public static final class DataType{
        // 显式声明String类型，直接赋值字符串字面量
        public static final String VARCHAR = "varchar";
    }
}

2. 绕开跨类引用，注解参数直接传入字面量 #

这是适配老版本Gradle最稳妥的修复方式，不需要调整构建配置，直接把注解里的跨类常量替换为对应字面量即可，从根源上避免编译期常量解析失败的问题：

@Table
public class MyClass{
    public static final String COL_NAME = "name";
    // 注解入参直接写字面量，不引用其他类的静态常量
    @Column(name = "name", columnDefinition = "varchar")
    private String name;
}

如果担心硬编码的维护问题，可以保留类内的COLTYPE_NAME常量供普通业务代码引用，仅替换注解内的参数值即可。

3. 调整Gradle编译配置，关闭影响常量解析的特性 #

针对Gradle 4.10.2的已知问题，修改build.gradle中的Java编译任务配置，规避类加载顺序异常导致的常量误判：

tasks.withType(JavaCompile) {
    // 关闭增量编译的类路径隔离逻辑
    options.incremental = false
}

该调整会略微降低增量编译的速度，但能解决老版本Gradle在跨类常量引用时的常量表达式校验bug。

4. 注解处理器类路径优先级调整 #

如果项目使用了Lombok、JPA元模型生成等注解处理器，需要在构建配置中明确把公共常量模块的类路径优先级前置，避免注解处理器在扫描代码时，加载到尚未完成编译的DB类，导致常量值无法被正确识别：

dependencies {
    annotationProcessor 'org.projectlombok:lombok'
    // 将存放DB常量的公共模块放到编译类路径最高优先级
    implementation project(':common-db-module')
}

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