Lombok失效问题：内部类声明方式引发的编译错误排查

我因为代码里有大量嵌套内部类，写了个直接返回结果的getFee()方法，但发现不同的内部类引用方式会让Lombok失效，出现编译错误。下面是失败案例、报错信息和成功案例，想搞清楚差异的原因。

失败案例代码 #

package com.corp.test.block.dto.test;

import java.util.List;

import com.corp.test.block.dto.test.TransactionDataDto.Tx.AuthInfo.Fee; //<- 失败点：提前导入未定义的内部类

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Getter
@NoArgsConstructor
@AllArgsConstructor
public class TransactionDataDto {
    private Tx tx;
    private TxResponse txResponse;

    public Fee getFee(){ // <- 失败点：使用导入的Fee作为返回类型
        return tx.authInfo.getFee();
    }

    @Getter
    public static class Tx{
        @Getter
        @Setter
        public static class AuthInfo{
            private Fee fee;

            @Getter
            public static class Fee{
                private String gasLimit;
            }
        }
    }
}

报错信息 #

java: cannot find symbol
  symbol:   class Getter
  location: class com.corp.test.block.dto.test.TransactionDataDto

成功案例代码 #

package com.corp.test.block.dto.test;

import java.util.List;

import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Getter;
import lombok.NoArgsConstructor;

@Getter
@NoArgsConstructor
@AllArgsConstructor
public class TransactionDataDto {
    private Tx tx;
    private TxResponse txResponse;

    public Tx.AuthInfo.Fee getFee(){ // <- 成功点：使用内部类的相对路径作为返回类型
        return tx.authInfo.getFee();
    }

    @Getter
    public static class Tx{
        @Getter
        @Setter
        public static class AuthInfo{
            private Fee fee;

            @Getter
            public static class Fee{
                private String gasLimit;
            }
        }
    }
}

原因分析 #

• 非法导入打乱编译流程
  失败案例里，你在TransactionDataDto类定义之前就导入了它的内部类TransactionDataDto.Tx.AuthInfo.Fee——这时候这个内部类还没被定义，属于非法导入。编译器处理这个错误导入时会出现解析异常，连带着后面Lombok注解的导入也没被正确识别，所以它不知道@Getter是什么，就抛出了“找不到Getter类”的错误。

• 内部类引用方式影响解析顺序
  成功案例里，方法返回类型用Tx.AuthInfo.Fee这种类内部的相对路径引用，编译器会在处理TransactionDataDto类的过程中，逐步解析嵌套的内部类，不会触发提前的无效导入解析。此时Lombok的注解处理器能正常工作，识别@Getter并生成对应的getter方法，编译流程不受干扰。

• Lombok注解的处理时机限制
  Lombok是在Java编译的注解处理阶段工作的，需要编译器先正确解析类的基础结构和所有导入语句。失败案例中的非法导入打破了这个顺序，导致注解处理器无法正常识别Lombok注解，最终引发编译错误。

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