Lombok @UtilityClass静态导入疑问：文档说明与实际使用不符？

问题描述 #

Lombok官方文档曾指出@UtilityClass不支持非星号静态导入：

由于javac的限制，目前无法使用非星号静态导入来导入@UtilityClass中的内容；请勿使用静态导入，或使用星号导入。

但实际测试发现非星号静态导入可以正常工作，测试代码如下：

工具类代码 #

@UtilityClass
public class AuthenticationUtils {
    public UUID getClientId(Authentication authentication) {
        return UUID.fromString(authentication.getName());
    }
}

控制器代码 #

import static by.afinny.apigateway.util.AuthenticationUtils.getClientId;

// more annotations
@RestController
public class CreditCardController {
    @GetMapping
    public ResponseEntity<List<CreditCardDto>> getCreditCards(Authentication authentication) {
        return creditCardClient.getCreditCards(getClientId(authentication));
    }
}

测试类代码 #

@WebMvcTest(CreditCardController.class)
class CreditCardControllerTest {
    // tests that pass
}

疑问：该问题是否已修复？还是文档的表述另有含义？

解答 #

这个情况主要有两种可能：

• Lombok版本更新修复了问题
  早期版本的Lombok受限于javac的编译逻辑，确实无法支持@UtilityClass的非星号静态导入。但随着Lombok迭代，后续版本（如1.18.x之后的部分版本）已经修复了该问题，适配了javac的编译流程，让非星号静态导入可以正常工作。

• 文档存在滞后性
  Lombok官方文档的更新有时会落后于代码修复进度，文档里的说明可能还停留在旧版本的限制描述，没有及时同步更新。

另外需要注意，在一些特殊场景下可能仍有兼容问题：比如使用老旧的javac版本、搭配特殊编译插件时，可能还会遇到文档中描述的问题。但在主流JDK版本（JDK8及以上）和较新的Lombok版本组合下，非星号静态导入@UtilityClass中的方法已经可以正常使用。

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