Camel bean-validator分组验证触发FailedToStartRouteException启动失败

问题场景 #

Spring Boot 2.7.3项目中，搭配Apache Camel 3.18.1的camel-bean-validator-starter组件，使用自定义验证分组接口时出现异常：

• 常规无分组的bean-validator://x端点能正常启动
• 当指定分组参数.to("bean-validator://x?group=AdvancedValidation")时，项目启动失败，抛出FailedToStartRouteException，根因是java.lang.ClassNotFoundException: AdvancedValidation
• 尝试添加.class后缀、给分组接口加@Component注解均无效，但Spring MVC的@Validated(AdvancedValidation.class)验证完全正常

问题原因 #

Camel的Bean Validator组件在解析URL中的group参数时，默认通过字符串类名加载对应类，若只传入简单类名（如AdvancedValidation），Camel使用的类加载器无法在Spring Boot的类加载环境中定位到该类；而Spring MVC的@Validated是直接传入Class对象，不存在类加载的问题。

解决方案 #

方案1：使用全限定类名作为group参数 #

将分组接口的完整包路径+类名作为group参数值，比如你的AdvancedValidation接口位于com.example.demo.validation包下，端点配置改为：

.to("bean-validator://x?group=com.example.demo.validation.AdvancedValidation")

若需要同时指定多个分组，用逗号分隔：

.to("bean-validator://x?group=com.example.demo.validation.BasicValidation,com.example.demo.validation.AdvancedValidation")

方案2：通过Exchange属性传递分组类（推荐动态场景） #

不在URL中指定group参数，而是在路由的Processor中直接将分组Class对象放入Exchange的指定属性，Camel会自动读取该属性进行分组验证：

import org.apache.camel.component.bean.validator.BeanValidator;

// ...
from("timer:val-timer?period=5000")
    .process(exchange -> {
        SimpleDto simpleDto = new SimpleDto();
        exchange.getIn().setBody(simpleDto);
        // 设置验证分组到Exchange属性
        exchange.setProperty(BeanValidator.GROUP, AdvancedValidation.class);
        // 多分组可以传入Class数组
        // exchange.setProperty(BeanValidator.GROUP, new Class[]{BasicValidation.class, AdvancedValidation.class});
    })
    .log("Setted body: ${body}")
    .to("bean-validator://x")
    .log("Validated message");

方案3：强制Camel使用Spring上下文类加载器（可选兜底） #

如果前两种方案仍有问题，可在RouteBuilder中显式设置Camel上下文使用当前线程的上下文类加载器（即Spring的类加载器）：

@Override
public void configure() throws Exception {
    // 强制使用Spring上下文类加载器
    getContext().setApplicationContextClassLoader(Thread.currentThread().getContextClassLoader());
    
    from("timer:val-timer?period=5000")
        // ... 后续路由逻辑
}

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