开发专用Spring Bean最佳实践：实现隔离及生产构建排除方案

一、创建开发专用Bean #

通过Spring Profile+目录隔离的方式实现，确保开发Bean仅在dev环境加载：

• 新建src/dev/java目录，将所有开发专用Bean（如Mock服务、测试配置类）放在该目录下。
• 给这些Bean添加@Profile("dev")注解，若需要覆盖生产环境同类型Bean，可搭配@Primary注解：

@Configuration
@Profile("dev")
public class DevMockConfig {
    @Bean
    @Primary
    public PaymentService mockPaymentService() {
        return amount -> {
            System.out.println("Mock支付成功，金额：" + amount);
            return true;
        };
    }
}

二、生产构建自动排除开发类（无需手动排除） #

利用Gradle的Source Sets实现目录级隔离，无需逐个配置类排除规则，IDE会自动识别配置：

Groovy版本（build.gradle） #

sourceSets {
    dev {
        java {
            srcDir 'src/dev/java'
        }
        resources {
            srcDir 'src/dev/resources'
        }
    }
    main {
        // 开发阶段让主源码集能访问dev目录代码
        compileClasspath += dev.output
        runtimeClasspath += dev.output
    }
}

// 生产Jar打包时自动排除dev目录下所有代码
tasks.jar {
    sourceSets.dev.java.srcDirs.each { dir ->
        def relativePath = projectDir.toURI().relativize(dir.toURI())
        exclude "${relativePath}/**"
    }
}

// 开发启动时自动包含dev目录代码
tasks.bootRun {
    classpath += sourceSets.dev.output
}

Kotlin DSL版本（build.gradle.kts） #

sourceSets {
    create("dev") {
        java.srcDir("src/dev/java")
        resources.srcDir("src/dev/resources")
    }
    main {
        compileClasspath += sourceSets["dev"].output
        runtimeClasspath += sourceSets["dev"].output
    }
}

tasks.jar {
    sourceSets["dev"].java.srcDirs.forEach { dir ->
        val relativePath = projectDir.toURI().relativize(dir.toURI())
        exclude("$relativePath/**")
    }
}

tasks.bootRun {
    classpath += sourceSets["dev"].output
}

方案优势 #

1. 开箱即用：同步Gradle项目后，IntelliJ/Eclipse会自动将src/dev/java标记为源码目录，无需手动配置IDE。
2. 彻底隔离：生产Jar中完全不包含开发类，从根源避免意外激活风险，比仅依赖Profile更安全。
3. 低出错率：通过目录批量隔离开发代码，避免逐个添加类排除规则的失误。
4. 双重保险：即使极端情况下开发类被误打包，@Profile("dev")也会阻止其在生产环境加载。

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