Quarkus创建SOAP客户端无法导入@CXFClient注解如何解决

问题原因 #

• 依赖引入不全：0.7 版本属于 quarkus-cxf 的早期开发版本，@CXFClient 注解未包含在核心 quarkus-cxf 依赖包中，需额外引入客户端专用依赖才能使用。
• 版本适配问题：0.7 版本的注解包路径与后续正式版本存在差异，且该版本功能不稳定，也可能出现注解类缺失的问题。
• 代码导入缺失：现有代码未导入 @Inject 注解的相关包，同时类上的 @Application 为无效注解，也会引发编译异常。
• 依赖缓存损坏：本地 Maven/Gradle 缓存损坏也可能导致已引入的依赖类无法正常识别。

解决方案 #

方案1：升级到稳定正式版本（推荐） #

如果当前项目使用的 Quarkus 版本为 2.x 及以上，直接替换原有依赖为匹配 Quarkus 版本的稳定版 quarkus-cxf 即可，稳定版本已将客户端相关能力整合到核心依赖中：

<dependency>
  <groupId>io.quarkiverse.cxf</groupId>
  <artifactId>quarkus-cxf</artifactId>
  <version>2.7.0</version> <!-- 可替换为与你项目Quarkus版本匹配的最新稳定版 -->
</dependency>

依赖替换完成后，修正代码中的两处错误即可正常编译：

1. 新增 @Inject 注解的导入语句：import javax.inject.Inject;
2. 将类上的无效注解 @Application 修改为 @ApplicationScoped

方案2：保留0.7版本的修复方式 #

如果因项目兼容性要求必须保留 0.7 版本，需额外补充客户端专用依赖：

<dependency>
  <groupId>io.quarkiverse.cxf</groupId>
  <artifactId>quarkus-cxf-client</artifactId>
  <version>0.7</version>
</dependency>

引入后同样修正上述代码错误即可识别@CXFClient注解。

方案3：修复缓存问题 #

如果确认依赖配置无误仍无法识别注解，执行以下操作刷新缓存即可：

1. 执行mvn clean install（Gradle项目执行./gradlew clean build）强制重新拉取依赖
2. 清空IDE缓存并重启，重新编译项目

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