如何仅在非本地环境启用Spring的@EnableEurekaClient注解？

这问题我之前开发Spring Boot应用时也碰到过，本地调试还要连Eureka注册中心确实没必要，给你几个实用的解决方案，都能完美实现需求：

方案一：使用@Profile注解拆分配置 #

最直观的方式是把Eureka客户端的配置单独抽成一个配置类，然后用@Profile指定它只在非local环境下生效，主类就不用加@EnableEurekaClient了：

1. 修改主类 #

去掉主类上的@EnableEurekaClient，保持干净：

public class UserServiceApplication extends WebMvcConfigurer {
    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }
}

2. 创建Eureka客户端配置类 #

单独写一个配置类，用@Profile("!local")表示除了local环境之外的所有环境都会加载这个类：

@Configuration
@EnableEurekaClient
@Profile("!local")
public class EurekaClientConfiguration {
    // 这里可以添加Eureka相关的自定义配置，比如实例ID、心跳配置等
}

3. 本地环境启用local profile #

本地启动应用时，设置spring.profiles.active=local即可：

• IDEA中：在Run/Debug Configuration的VM options里添加-Dspring.profiles.active=local
• 命令行启动：java -jar your-app.jar --spring.profiles.active=local

这样本地环境下，Eureka客户端的配置类不会被加载，自然就不会启用Eureka客户端了。

方案二：使用@ConditionalOnProperty基于配置属性控制 #

如果不想用profile，也可以通过配置属性来开关Eureka客户端：

1. 创建带条件的Eureka配置类 #

用@ConditionalOnProperty判断指定配置属性的值，决定是否启用Eureka客户端：

@Configuration
@EnableEurekaClient
@ConditionalOnProperty(
    name = "eureka.client.enabled",
    havingValue = "true",
    matchIfMissing = true // 当属性未配置时默认启用，兼容现有非本地环境
)
public class EurekaClientConfiguration {
}

2. 本地配置禁用Eureka #

在本地的配置文件（比如application-local.yml）中添加：

eureka:
  client:
    enabled: false

同样，本地启动时指定spring.profiles.active=local，就会加载这个配置，禁用Eureka客户端；其他环境如果不配置这个属性，就会默认启用Eureka客户端。

方案对比 #

• @Profile方案逻辑清晰，适合按环境拆分配置的场景，后续扩展其他环境配置也很方便
• @ConditionalOnProperty方案更灵活，能通过配置属性细粒度控制，适合需要动态开关的场景

你可以根据自己项目的配置习惯选择合适的方式，两种都能完美解决你的问题。

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