使用Apache Camel Jetty组件搭建HTTP代理启动失败排查

问题背景 #

作为Apache Camel新手，尝试搭建HTTP代理转发Camunda Engine的所有REST API，参考Jetty组件文档及Camel代理实现指南后，编写了以下代码及依赖配置，但启动时出现错误。

路由代码 #

@Override
public void configure() throws Exception {
    from("jetty:http://localhost:8081/engine-rest?matchOnUriPrefix=true")
            .to("jetty:http://localhost:8080/engine-rest/");
}

Spring Boot POM依赖 #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-spring-boot-starter</artifactId>
    <version>3.2.0</version>
</dependency>

<dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-jetty-starter</artifactId>
    <version>3.2.0</version>
    <!-- use the same version as your Camel core version -->
</dependency>

启动错误日志 #

org.apache.camel.FailedToStartRouteException: Failed to start route route1 because of null
    ...（省略中间堆栈信息）
Caused by: java.lang.UnsupportedOperationException: This component does not support producer.
    at org.apache.camel.component.jetty.JettyHttpEndpoint.createProducer(JettyHttpEndpoint.java:95) ~[camel-jetty-common-3.2.0.jar:3.2.0]
    ...（省略中间堆栈信息）

错误原因 #

核心问题在于Jetty组件仅支持作为消费者接收HTTP请求，不支持作为生产者发送HTTP请求。你在路由的to()方法中使用jetty:端点，试图让Jetty发送请求到Camunda，这违反了Jetty组件的设计限制，因此抛出异常。

解决方案 #

1. 替换生产者组件 #

将路由中to()的Jetty端点替换为支持HTTP请求发送的http4组件（基于Apache HttpClient 4），同时添加bridgeEndpoint=true参数确保原始请求的URI路径被完整转发：

@Override
public void configure() throws Exception {
    from("jetty:http://localhost:8081/engine-rest?matchOnUriPrefix=true")
            .to("http4://localhost:8080/engine-rest?bridgeEndpoint=true&throwExceptionOnFailure=false");
}

• bridgeEndpoint=true：忽略to()端点中指定的路径，使用原始请求的完整路径转发
• throwExceptionOnFailure=false：避免Camunda返回的非2xx状态码触发Camel异常，保持响应原样返回

2. 添加HTTP客户端依赖 #

在POM中添加camel-http4-starter依赖（版本需与Camel核心版本一致）：

<dependency>
    <groupId>org.apache.camel.springboot</groupId>
    <artifactId>camel-http4-starter</artifactId>
    <version>3.2.0</version>
</dependency>

3. 解决容器冲突（可选） #

Spring Boot Starter Web默认使用Tomcat服务器，与引入的Jetty组件可能存在冲突，可通过排除Tomcat依赖解决：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

替代方案 #

如果需要更简洁的代理实现，可考虑：

• 使用camel-rest-proxy组件：专门针对REST代理场景，配置更简化
• 使用Spring Cloud Gateway：若项目已基于Spring Cloud生态，其代理配置更直观

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