Quarkus中Apache CXF SOAP服务添加lambda-rest扩展后报错排查

一、注解补全建议 #

你的SOAP服务实现类缺少关键的接口绑定配置，导致Quarkus无法正确关联WSDL定义与服务实现。修改实现类的@WebService注解，补充完整参数：

@WebService(
    serviceName = "myServiceName",
    endpointInterface = "com.your.package.myGeneratedServiceName", // 替换为生成接口的全类名
    targetNamespace = "http://myGeneratedNameSpace.com"
)

确保：

• endpointInterface指向wsdl2java生成的服务接口
• targetNamespace与生成接口的注解值完全一致，无拼写或大小写错误

二、增加调试日志的方法 #

在application.properties中添加以下配置，获取请求路由与SOAP处理的详细日志：

# 开启JAX-WS核心组件调试日志
quarkus.log.category."com.sun.xml.ws".level=DEBUG
quarkus.log.category."org.jboss.ws".level=DEBUG
# 开启HTTP请求路由追踪日志
quarkus.log.category."io.quarkus.vertx.http".level=DEBUG

通过日志可以确认?wsdl请求是否被Lambda REST扩展拦截，以及SOAP服务解析请求的具体过程。

三、Lambda REST扩展冲突的解决方案 #

这不是预期行为，属于扩展间的路由优先级冲突——Lambda REST扩展会接管大部分HTTP请求的处理逻辑，干扰了SOAP服务的WSDL请求解析。可通过以下方式规避：

1. 为SOAP服务指定独立路径
   在application.properties中配置SOAP服务的专属上下文路径：

quarkus.jaxws.endpoint."myServiceName".context-path=/soap-endpoint

此时WSDL地址变为/soap-endpoint?wsdl，与REST服务路径彻底隔离。
2. 限制Lambda扩展的路由范围
如果REST服务有固定前缀（如/api），配置Lambda扩展仅处理该路径下的请求：

quarkus.amazon.lambda.rest.path=/api/*

非/api开头的请求会自动交给JAX-WS扩展处理。

四、缺陷报告提交建议 #

若上述规避方法无效，建议提交缺陷报告到Quarkus官方仓库，提交时需包含：

• 最小可复现的项目代码（含生成的SOAP接口、实现类、pom.xml依赖）
• 测试使用的Quarkus版本（2.16.4/3.0）
• 完整的错误日志输出
• 扩展冲突的场景描述（添加Lambda扩展前后的行为差异）

五、REST+SOAP共存的最佳实践 #

针对你的多环境需求：

• 严格隔离REST与SOAP服务的路径，避免路由冲突
• 通过Maven/Gradle Profile区分环境：Lambda环境启用quarkus-amazon-lambda-rest扩展，Fargate环境仅保留REST与SOAP扩展
• 测试阶段分别验证两类端点的可用性，确保扩展间无互相干扰

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