Gradle使用compileOnly引入Lombok为何无法在测试中生效？

问题场景 #

在build.gradle中配置Lombok依赖如下：

compileOnly 'org.projectlombok:lombok'
annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'
annotationProcessor 'org.projectlombok:lombok'

主业务代码中使用Lombok注解完全正常，但在测试代码里用Lombok注解时，会提示Lombok不可用的错误。把compileOnly改成implementation后错误消失，但疑惑的是：测试类路径为什么不继承主类路径的compileOnly依赖？

核心原因 #

Gradle的依赖配置有明确的作用范围划分：

• compileOnly的作用范围仅限主代码的编译阶段，这个依赖只会被加入主代码的编译类路径，不会传递到测试代码的编译或运行类路径。它的设计目的就是提供“编译时需要、运行时不需要”的依赖，比如Lombok这类编译期注解处理器，主代码编译完成后就不再需要它。
• 测试代码的类路径虽然会继承主代码的implementation、api等和运行时相关的依赖，但不会自动继承compileOnly这种仅主编译阶段的依赖。因为测试代码本身是独立的编译单元，它的编译类路径是单独维护的，主代码的compileOnly依赖不会默认包含进去。

正确解决方案 #

没必要把compileOnly改成implementation（这会导致Lombok被打包到最终产物里，不符合它的使用规范），正确的做法是给测试代码单独配置对应的依赖：

// 主代码的Lombok配置
compileOnly 'org.projectlombok:lombok'
annotationProcessor 'org.projectlombok:lombok'
annotationProcessor 'org.springframework.boot:spring-boot-configuration-processor'

// 测试代码的Lombok配置
testCompileOnly 'org.projectlombok:lombok'
testAnnotationProcessor 'org.projectlombok:lombok'

这样既能保证主代码和测试代码都能正常使用Lombok，又不会把Lombok冗余打包到最终应用中。

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