如何在Spring Boot中使用Apache Camel platform-http组件？

当你在Spring Boot中使用如下Platform-HTTP路由时：

from("platform-http:/test?httpMethodRestrict=POST")
    .to("log:foo");

遇到异常：

Caused by: java.lang.IllegalStateException: PlatformHttpEngine is neither set on this endpoint neither found in Camel Registry or FactoryFinder.

这是因为官方文档（3.18.x版本）未明确Spring Boot环境下的适配配置步骤，以下是完整的解决方法：

1. 引入正确的Starter依赖 #

Spring Boot环境下必须引入Camel Platform-HTTP的starter包，确保与你的Camel版本一致（以Maven为例）：

<dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-platform-http-starter</artifactId>
    <version>3.18.x</version>
</dependency>

2. 注册ServletPlatformHttpEngine Bean #

Spring Boot基于Servlet容器运行，需要注册适配Servlet环境的ServletPlatformHttpEngine到Spring上下文：

import org.apache.camel.component.platform.http.servlet.ServletPlatformHttpEngine;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class CamelPlatformHttpConfig {

    @Bean
    public ServletPlatformHttpEngine servletPlatformHttpEngine() {
        return new ServletPlatformHttpEngine();
    }
}

你也可以通过配置文件调整引擎参数，比如设置全局上下文路径：

# application.properties
camel.component.platform-http.engine.servlet.context-path=/api

3. 验证路由 #

保持你的路由配置不变，启动Spring Boot应用后，向http://localhost:8080/test发送POST请求，即可触发路由并在日志中看到foo日志输出。

额外说明 #

官方文档中“开箱即用”的描述针对的是Quarkus或Camel独立运行环境，在Spring Boot环境下需要显式引入starter并配置Servlet适配引擎，因为两者的底层HTTP服务机制不同。

内容的提问来源于stack exchange，提问作者Marian Klühspies