Spring Boot如何实现仅在开发者本地运行时生效的conditional bean

我们可以通过多维度组合判断来提升本地开发环境识别的准确率，不需要依赖Spring Profile，完全自动完成环境区分，不会出现本地配置忘改导致服务端运行异常的问题。

完整实现代码 #

import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;
import java.net.InetAddress;
import java.net.UnknownHostException;

public class LocalDeveloperCondition implements Condition {

    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        // 维度1：检查是否通过IDE启动，识别准确率最高
        String classPath = System.getProperty("java.class.path", "");
        if (classPath.contains("idea_rt.jar") || classPath.contains("eclipse") || classPath.contains("vscode")) {
            return true;
        }

        // 维度2：检查主机名是否符合开发机常见命名特征
        try {
            String hostName = InetAddress.getLocalHost().getHostName().toLowerCase();
            if (hostName.contains("localhost") 
                || hostName.contains("desktop") 
                || hostName.contains("laptop") 
                || hostName.contains("macbook")
                || hostName.contains("pc-")
                || hostName.endsWith(".local")) { // Mac设备默认主机名后缀为.local
                return true;
            }
        } catch (UnknownHostException e) {
            // 异常场景兜底返回false，避免服务器环境误判
            return false;
        }

        // 维度3：补充判断系统环境特征，排除服务器常用运行场景
        String userName = System.getProperty("user.name", "").toLowerCase();
        // 排除服务器常用运行账号，可根据自己团队的服务器配置补充排除名单
        if (!userName.equals("root") && !userName.equals("www") && !userName.equals("admin") && !userName.equals("tomcat")) {
            String userHome = System.getProperty("user.home", "");
            // 匹配个人设备默认用户目录规则，以及本地开发常用IDE配置目录
            if (userHome.contains("/Users/") || userHome.contains("C:\\Users\\")
                || new java.io.File(userHome, ".intellij").exists()
                || new java.io.File(userHome, ".vscode").exists()) {
                return true;
            }
        }

        // 所有维度都不匹配，判定为服务器环境
        return false;
    }
}

使用方式 #

直接在你需要条件加载的Bean上添加注解即可：

@Bean
@Conditional(LocalDeveloperCondition.class)
public ObservationWebSocketClient observationWebSocketClient(){
    log.info("creating web socket connection...");
    return new ObservationWebSocketClient();
}

方案说明 #

• 多维度组合判断的准确率极高，基本不会出现服务器环境误判的情况，也不需要开发者手动配置任何Profile参数
• 所有异常场景都做了兜底处理，不会影响服务正常启动
• 可以根据团队实际情况灵活调整判断规则，比如你们公司服务器主机名统一带prod-/dev-前缀，可以补充对应排除逻辑

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