Apache CXF集成OpenApiFeature后所有端点返回相同响应且调用路径错误

问题1：所有CXF端点的openapi.json返回相同响应内容 #

排查优先级从高到低：

• 确认是否为每个独立的JAX-RS端点分别注册独立的OpenApiFeature实例：如果全局仅注册了一个共享的OpenApiFeature单例，所有端点会复用同一套OpenAPI元数据，导致返回内容完全一致。需要为每个JAXRSServerFactoryBean分别创建新的OpenApiFeature对象单独配置。
• 检查OpenApiFeature的configLocation属性：如果多个端点绑定了同一个openapi配置文件，也会导致返回内容一致，需为不同端点配置独立的元数据文件，或通过代码动态配置对应端点的接口信息。
• 为每个OpenApiFeature实例设置唯一的contextId属性：避免CXF内部缓存混用不同端点的OpenAPI元数据。

问题2：Swagger UI发起请求时缺失路径前缀 #

排查优先级从高到低：

• 检查OpenApiFeature的basePath配置：需要为每个端点显式设置对应路径前缀，比如carSample端点需配置basePath = "/api/carSample"，OpenAPI生成的接口路径会自动拼接该前缀。
• 限制每个OpenApiFeature的扫描范围：如果扫描包路径包含了多个端点的接口类，会导致路径计算错误，需将resourcePackages配置为仅包含对应端点的接口类所在包。
• 补充服务根路径配置：如果CXF Servlet的映射路径和业务端点的统一前缀不一致，可以通过配置serverRoot属性补全请求地址前缀，避免Swagger UI直接从服务根路径发起请求。
• 极端场景下可以自定义OpenApiCustomizer：在OpenApiFeature中添加自定义处理器，统一为所有接口路径补全对应端点的前缀。

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