Spring未扫描创建Bean，Camunda无法识别sqlDataRetrievalDelegate求助

一、本地mvn spring-boot:run找不到main方法的问题 #

这是Spring Boot项目缺少启动类或启动类配置不正确导致的，按以下步骤修复：

• 添加Spring Boot启动类：在项目根包下创建带@SpringBootApplication注解的启动类，示例代码：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class CamundaBpmnStarter {
    public static void main(String[] args) {
        SpringApplication.run(CamundaBpmnStarter.class, args);
    }
}

• 检查Maven插件配置：确保pom.xml中包含Spring Boot打包插件，避免构建时无法识别启动类：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

• 确认Camunda Starter依赖：如果是Spring Boot集成Camunda，必须引入对应版本的Camunda Starter依赖：

<dependency>
    <groupId>org.camunda.bpm.springboot</groupId>
    <artifactId>camunda-bpm-spring-boot-starter</artifactId>
    <version>7.21.0</version> <!-- 版本需与你的Camunda容器匹配 -->
</dependency>

二、Camunda容器中找不到sqlDataRetrievalDelegate Bean的问题 #

核心原因是Spring未扫描到Delegate类并注册为Bean，或部署方式不符合Camunda要求：

1. 让Delegate类被Spring管理 #

在SqlDataRetrievalDelegate类上添加@Component注解（可指定Bean名称，确保与BPMN表达式一致）：

import org.camunda.bpm.engine.delegate.DelegateExecution;
import org.camunda.bpm.engine.delegate.JavaDelegate;
import org.springframework.stereotype.Component;

@Component("sqlDataRetrievalDelegate")
public class SqlDataRetrievalDelegate implements JavaDelegate {
    @Override
    public void execute(DelegateExecution execution) throws Exception {
        // 你的SQL查询逻辑
    }
}

如果不指定Bean名称，Spring默认会用类名首字母小写作为Bean名（即sqlDataRetrievalDelegate），也能匹配表达式，但显式指定更稳妥。

2. 确保Spring扫描到Delegate类 #

• 启动类的@SpringBootApplication默认扫描自身所在包及子包，如果Delegate类在其他路径，需添加@ComponentScan指定扫描范围：

@SpringBootApplication
@ComponentScan(basePackages = {"com.yourpackage.delegates", "com.yourpackage"})
public class CamundaBpmnStarter {
    // main方法
}

3. 适配Camunda容器部署方式 #

如果是部署到独立Camunda容器（如Tomcat上的Camunda），而非Spring Boot内嵌容器：

• 改用camunda-bpm-maven-plugin打包成WAR格式的流程应用，而非JAR。
• 在META-INF/processes.xml中配置Delegate类的部署，或用@Named注解替代@Component。
• 确保依赖中包含Camunda与Spring的桥接包：

<dependency>
    <groupId>org.camunda.bpm</groupId>
    <artifactId>camunda-engine-spring</artifactId>
    <version>7.21.0</version>
</dependency>

• 将包含Delegate的JAR放入Camunda容器的lib目录，或打包成包含所有依赖的流程应用WAR。

4. 验证Bean是否存在 #

本地启动后，可通过以下方式确认Bean已被注册：

• 添加Spring Boot Actuator依赖，访问http://localhost:8080/actuator/beans搜索sqlDataRetrievalDelegate：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

• 编写单元测试注入Delegate，验证是否能获取到Bean：

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest
public class DelegateBeanTest {
    @Autowired
    private SqlDataRetrievalDelegate delegate;

    @Test
    public void testBeanExists() {
        assert delegate != null;
    }
}

三、额外排查点 #

• 检查pom.xml中Camunda与Spring Boot版本是否兼容（参考Camunda官方版本兼容矩阵）。
• 查看Camunda容器日志，确认是否存在类加载异常（如JDBC驱动缺失）。
• 排查依赖冲突，用mvn dependency:tree命令查看依赖树，排除重复或冲突的包。

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