Spring Boot集成嵌入式Camunda 7注册Eureka时遇依赖异常问题

问题原因 #

Spring Boot 3.2.5 + Spring Cloud 2023.0.2 与 Camunda 7.21.0 整合时，出现 UnsatisfiedDependencyException: Error creating bean with name 'scopedTarget.eurekaClient' 错误，核心原因是Camunda Spring Boot Starter 与 Spring Cloud Eureka Client 的依赖或 bean 配置存在冲突：

• Camunda 自身的自动配置可能覆盖或干扰了 Eureka Client 的作用域代理设置
• 依赖版本不兼容，Camunda 引入的间接依赖与 Spring Cloud 指定版本冲突

解决方案 #

1. 排除 Camunda Starter 中冲突的 Eureka 依赖 #

在 pom.xml 中，排除 Camunda Starter 自带的 Spring Cloud Eureka 相关依赖，强制使用项目中指定的 Spring Cloud 版本：

<dependency>
    <groupId>org.camunda.bpm.springboot</groupId>
    <artifactId>camunda-bpm-spring-boot-starter</artifactId>
    <version>7.21.0</version>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.cloud</groupId>
            <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
        </exclusion>
        <!-- 若存在其他Spring Cloud相关冲突依赖，一并排除 -->
    </exclusions>
</dependency>

然后手动引入对应 Spring Cloud 版本的 Eureka Client 依赖：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    <version>4.1.2</version> <!-- 对应Spring Cloud 2023.0.2的官方适配版本 -->
</dependency>

2. 确保 Eureka 自动配置生效 #

• 在项目主启动类上添加 @EnableDiscoveryClient 注解（Spring Cloud 2023.0.2 中 @EnableEurekaClient 已废弃，推荐使用前者）
• 在配置文件（application.properties/yml）中开启服务发现：

spring.cloud.discovery.enabled=true
eureka.client.enabled=true
eureka.client.service-url.defaultZone=http://你的Eureka服务器地址:端口/eureka/

3. 显式声明 EurekaClient Bean 并指定作用域 #

若作用域代理冲突导致 bean 创建失败，可在自定义配置类中显式定义 EurekaClient，指定正确的作用域：

import com.netflix.discovery.EurekaClient;
import com.netflix.discovery.EurekaClientConfig;
import org.springframework.cloud.netflix.eureka.CloudEurekaClient;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Scope;
import org.springframework.context.annotation.ScopedProxyMode;

@Configuration
public class EurekaClientConfig {

    @Bean
    @Scope(value = "refresh", proxyMode = ScopedProxyMode.TARGET_CLASS)
    public EurekaClient eurekaClient(EurekaClientConfig clientConfig) {
        return new CloudEurekaClient(new com.netflix.discovery.DiscoveryClient.DiscoveryClientOptionalArgs(), clientConfig);
    }
}

4. 检查端口与上下文路径冲突 #

确保 Camunda 服务的端口与 Eureka 服务器端口不重复（Camunda 默认端口为 8080），可在配置文件中修改：

server.port=8081

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