如何配置Java/Gradle实现包依赖校验 违规导入时自动终止构建

完全可以通过Gradle配置配合校验工具实现需求，违规导入会直接中断构建流程，不需要侵入业务代码实现。

目前有两种成熟的落地路径，优先推荐第一种：

方案1：集成ArchUnit做架构守护（生产环境首选） #

ArchUnit是Java生态专门用于架构规则校验的工具，可以直接嵌入Gradle构建生命周期，扫描字节码层面的依赖关系，不会出现漏检，规则扩展灵活。
配置步骤：

• 首先在项目build.gradle中引入依赖，依赖范围设为测试依赖，不会打入生产制品：

dependencies {
    testImplementation 'com.tngtech.archunit:archunit-junit5:1.2.1'
}

• 在测试源码目录下新增分层规则校验测试类，定义domain层禁止依赖infrastructure层的规则：

import com.tngtech.archunit.core.importer.ClassFileImporter;
import com.tngtech.archunit.lang.ArchRule;
import org.junit.jupiter.api.Test;
import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;

public class OnionArchitectureRuleTest {
    @Test
    void domain_layer_must_not_depend_on_infrastructure_layer() {
        ArchRule rule = noClasses()
                .that().resideInAPackage("..domain..")
                .should().dependOnClassesThat()
                .resideInAPackage("..infrastructure..");
        // 替换为你自己项目的根包名
        rule.check(new ClassFileImporter().importPackages("com.your.project.basepackage"));
    }
}

配置完成后执行./gradlew build时会自动运行该测试，一旦检测到domain包下的类引用了infrastructure包的任何类，测试会直接失败，构建终止，错误日志会明确标注违规的类、引用位置，排查成本极低。后续如果要新增其他洋葱架构分层规则（比如core层禁止依赖外层包、application层禁止依赖controller包等），只需要在这个测试类里追加对应规则即可。

方案2：自定义Gradle源码扫描任务（轻量无额外依赖） #

如果不想引入第三方依赖，可以自定义Gradle任务在编译前扫描源码文本，检测违规导入直接终止构建。
在build.gradle中添加如下配置：

// 注册分层依赖校验任务
tasks.register('checkLayerDependency') {
    doLast {
        // 替换为你自己项目的domain包实际路径
        def domainPackagePath = "src/main/java/com/your/project/basepackage/domain"
        // 替换为你自己项目的infrastructure层包全限定名前缀
        def infraPackagePrefix = "com.your.project.basepackage.infrastructure"
        def violations = []

        file(domainPackagePath).eachFileRecurse { sourceFile ->
            if (!sourceFile.name.endsWith(".java")) return
            sourceFile.eachLine { content, lineNum ->
                def trimmed = content.trim()
                if (trimmed.startsWith("import") && trimmed.contains(infraPackagePrefix)) {
                    violations.add("违规位置：${sourceFile.path} 第${lineNum}行，违规内容：${trimmed}")
                }
            }
        }

        if (!violations.isEmpty()) {
            throw new GradleException("检测到洋葱架构分层依赖违规，构建终止：\n${violations.join("\n")}")
        }
    }
}

// 将校验任务绑定到Java编译任务前，构建时自动执行
tasks.named('compileJava') {
    dependsOn('checkLayerDependency')
}

该方案没有任何额外依赖，执行构建命令时会优先跑校验逻辑。缺点是仅基于文本匹配import语句，如果代码中直接写全限定类名调用infrastructure层类、没有显式写import语句会出现漏检，仅适合规则简单的小型项目。

不推荐Java原生机制实现的原因 #

Java本身没有提供分包场景下的依赖访问控制能力：

• 四种访问修饰符仅能控制类、方法、字段的可见范围，无法限制跨包的依赖引用行为
• 如果用Java 9+的JPMS模块系统做限制，需要将每个分层拆分为独立的Gradle子模块，改造成本高，对于单模块分包的项目性价比极低

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