Spring Boot+Apache Camel容器启动报错：RouteTemplate未找到

环境版本 #

• Spring Boot：2.7.6
• Apache Camel：3.20.2（也曾尝试3.16.0）

问题现象 #

在IDE（Eclipse/IntelliJ）中运行测试时，基于路由模板创建路由完全正常；但将服务打包部署到Docker容器启动时，抛出异常：

java.lang.IllegalArgumentException: Cannot find RouteTemplate with id listRegisteredServicesTemplate

相关代码 #

路由模板定义 #

@Override
public void configure() throws Exception {
    
    routeTemplate("listRegisteredServicesTemplate")
        .templateParameter("routeId")
        .templateParameter("filterString")
        .from("direct:{{routeId}}")
        .description("Provides filtered list of services registered to Consul")
        .to("direct:anotherRoute")
        .enrich();
}

基于模板创建路由的代码 #

@Component
public class ProcessModelRoutes extends RouteBuilder {

@Autowired
CamelContext camelContext;

@Override
public void configure() throws Exception {
    
    TemplatedRouteBuilder.builder(camelContext, "listRegisteredServicesTemplate")
        .routeId("aRoute")
        .parameter("routeId", "v1.com.xxx.aRoute")
        .parameter("filterString", "filter=ServiceID matches Pool")
        .add();
}

疑问 #

已尝试过TemplateRouteBuilder的DSL写法，请问路由模板未在Camel Context中加载的原因是什么？是否是加载顺序问题（比如Camel Context在模板注册前就尝试创建路由）？

你的猜测没错，核心问题就是路由模板的加载顺序晚于基于模板创建路由的代码执行时机，IDE和Docker容器的类加载/Bean初始化顺序差异导致了这个现象。

具体原因分析 #

1. IDE环境的特殊性：在IDE中运行时，类加载和Spring Bean初始化的顺序相对宽松，路由模板所在的RouteBuilder可能会先于ProcessModelRoutes完成初始化，模板提前注册到了Camel Context中。
2. Docker容器中的打包/初始化逻辑：当服务打包成Jar运行时，Spring Boot的Bean初始化顺序可能发生变化——ProcessModelRoutes作为@Component被扫描初始化时，路由模板所在的RouteBuilder还未完成模板注册，导致调用TemplatedRouteBuilder.builder时找不到对应模板ID。

解决方案 #

方案1：通过@Order控制Bean加载顺序

将路由模板所在的RouteBuilder标记为优先初始化，确保模板先注册到Camel Context：

@Component
@Order(Ordered.HIGHEST_PRECEDENCE)
public class RouteTemplates extends RouteBuilder {
    @Override
    public void configure() throws Exception {
        // 你的路由模板定义
        routeTemplate("listRegisteredServicesTemplate")
            .templateParameter("routeId")
            .templateParameter("filterString")
            .from("direct:{{routeId}}")
            .description("Provides filtered list of services registered to Consul")
            .to("direct:anotherRoute")
            .enrich();
    }
}

同时给ProcessModelRoutes设置较低优先级：

@Component
@Order(Ordered.LOWEST_PRECEDENCE)
public class ProcessModelRoutes extends RouteBuilder {
    // ... 原有代码
}

方案2：监听Camel Context启动事件延迟创建路由

避免在RouteBuilder.configure()中直接创建模板路由，改为在Camel Context完全启动、模板注册完成后再执行创建逻辑：

@Component
public class ProcessModelRoutes implements CamelContextAware, ApplicationListener<CamelContextStartedEvent> {

    private CamelContext camelContext;

    @Override
    public void setCamelContext(CamelContext camelContext) {
        this.camelContext = camelContext;
    }

    @Override
    public CamelContext getCamelContext() {
        return camelContext;
    }

    @Override
    public void onApplicationEvent(CamelContextStartedEvent event) {
        // 在Camel Context启动完成后创建模板路由
        TemplatedRouteBuilder.builder(camelContext, "listRegisteredServicesTemplate")
            .routeId("aRoute")
            .parameter("routeId", "v1.com.xxx.aRoute")
            .parameter("filterString", "filter=ServiceID matches Pool")
            .add();
    }
}

方案3：直接在模板定义中生成路由实例

如果模板和对应的路由是强绑定的，可以直接在路由模板类中通过templateRoute生成实例，跳过手动调用TemplatedRouteBuilder的步骤：

@Override
public void configure() throws Exception {
    routeTemplate("listRegisteredServicesTemplate")
        .templateParameter("routeId")
        .templateParameter("filterString")
        .from("direct:{{routeId}}")
        .description("Provides filtered list of services registered to Consul")
        .to("direct:anotherRoute")
        .enrich();

    // 直接基于模板创建路由
    templateRoute("listRegisteredServicesTemplate")
        .routeId("aRoute")
        .parameter("routeId", "v1.com.xxx.aRoute")
        .parameter("filterString", "filter=ServiceID matches Pool");
}

额外验证点 #

• 确认路由模板所在的类已被Spring扫描到（是否添加@Component，或在@SpringBootApplication的扫描路径范围内）。
• 打包Jar后，通过jar tf your-service.jar命令检查路由模板类是否被正确包含在Jar包中。

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