Camel多SEDA队列流水线中路由onCompletion不执行是否为设计预期？

现象复现 #

跨SEDA队列传递消息的Camel路由中，仅链路末端路由的路由级onCompletion回调会正常执行，前置路由配置的回调无任何触发。
复现配置如下：

from("direct:a")
  .onCompletion().log("a - done").end()
  .to("seda:b");

from("seda:b")
  .onCompletion().log("b - done").end()
  .to("seda:c");

from("seda:c")
  .onCompletion().log("c - done").end()
  .to("seda:d");

from("seda:d")
  .onCompletion().log("d - done").end()
  .to("mock:end");

运行上述代码控制台仅输出d - done日志，a、b、c三个路由的onCompletion逻辑均未执行。

根因解释 #

该现象属于SEDA组件的设计预期行为，并非框架Bug：

• SEDA是基于内存队列的异步组件，消息被发送到SEDA端点时，SedaProducer默认会创建原Exchange的关联副本供下游消费者使用。
• 创建副本时默认开启handoverOnCompletion=true配置，会将原Exchange上绑定的路由级onCompletion处理器全部移交到下游的副本Exchange上，不会在当前路由执行完投递动作后立即触发。
• 该设计的目的是避免异步场景下提前触发完成回调：如果不做移交，上游路由把消息放入SEDA队列后就会立即触发onCompletion，但此时下游消费者可能还未开始处理消息，回调语义与“消息处理完成”不符。
• 调试时观察到的SedaProducer::addToQueue固定传入copy=true、handover=true调用ExchangeHelper.createCorrelatedCopy，正是这套移交逻辑的实现入口。整条链路中只有最后一个路由（seda:d）没有继续向下游移交onCompletion处理器，因此只有它的回调会正常触发。

调整方案 #

根据业务语义选择对应配置即可：

• 如果需要每个路由的onCompletion在**当前路由完成消息投递（消息成功进入下游SEDA队列）**时就触发，在SEDA端点上关闭移交开关即可：

from("direct:a")
  .onCompletion().log("a - done").end()
  .to("seda:b?handoverOnCompletion=false");

from("seda:b")
  .onCompletion().log("b - done").end()
  .to("seda:c?handoverOnCompletion=false");

from("seda:c")
  .onCompletion().log("c - done").end()
  .to("seda:d?handoverOnCompletion=false");

from("seda:d")
  .onCompletion().log("d - done").end()
  .to("mock:end");

注意：该配置下a路由的onCompletion触发仅代表消息成功存入seda:b队列，不代表下游b/c/d路由的处理已经完成，无法感知后续链路的执行结果。

• 如果需要感知全链路的处理完成状态，保留默认的handover配置即可，若需要区分不同路由的执行节点，可配置全局onCompletion，通过Exchange上记录的当前路由ID做分支判断。

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