根本原因是WSDL地址不可达、XML不规范或JDK与CXF版本不兼容；JDK17+需显式添加JAXB依赖，推荐升级CXF至4.0.0+以原生支持Jakarta EE9+。
WSDL 生成客户端代码时 cxf-codegen-plugin 报错 “Failed to execute goal org.apache.cxf:cxf-codegen-plugin”
根本原因通常是 WSDL 地址不可达、XML 格式不规范，或插件版本与 JDK 不兼容。尤其 JDK 17+ 默认移除了 JAXB，而老版 CXF（如 3.4.x）仍强依赖它。
- 检查 WSDL 是否能被浏览器直接打开，且返回的是标准 XML（不是 HTML 登录页或 404）
- 若用 JDK 17+，必须显式添加 JAXB 依赖：
jakarta.xml.bind:jakarta.xml.bind-api和org.glassfish.jaxb:jaxb-runtime - 推荐升级 CXF 到
4.0.0+，它原生支持 Jakarta EE 9+ 命名空间，避免手动补依赖 - 命令行调试时加
-X参数看完整堆栈，重点找ClassNotFoundException: javax.xml.bind.JAXBContext或wsdl2java failed: invalid wsdl
用 wsdl2java 生成 Java 类，但调用时抛 javax.xml.ws.WebServiceException: Cannot create Endpoint
这不是代码生成问题，而是运行时缺少 JAX-WS 实现。JDK 11 起已移除内置 JAX-WS，必须显式引入实现库。
- Spring Boot 项目：加
spring-boot-starter-web-services，它会拉取spring-ws-core+saaj-impl - 纯 Java SE 项目：加
com.sun.xml.ws:jaxws-rt（注意是com.sun.xml.ws，不是javax.xml.ws的旧包） - 别混淆
wsimport（JDK 自带）和wsdl2java（CXF 提供）——前者生成的类默认绑定 Metro，后者绑定 CXF 运行时，混用会出NoClassDefFoundError - 生成时加
-p指定包名，避免和已有类冲突；加-d明确输出目录，防止 IDE 扫描不到
CXF 客户端调用报 Could not send Message，底层是 Connection refused 或 SSLHandshakeException
这是网络层或 TLS 配置问题，和 WSDL 解析、代码生成无关。常见于测试环境连生产服务，或启用了 HTTPS 但没配信任库。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 先用
curl -v http://host:port/service?wsdl确认基础连通性，排除防火墙或 DNS 问题 - HTTPS 场景下，如果服务端用自签名证书，需在客户端 JVM 启动参数加
-Djavax.net.ssl.trustStore=xxx.jks，或代码中设置SSLContext - CXF 客户端默认不走系统代理，如需代理，得手动配置：
HTTPConduit上设ProxyClient，不能只靠http.proxyHost系统属性 - 超时务必显式设，否则默认是无限等待：
client.getRequestContext().put("javax.xml.ws.client.receiveTimeout", 30000)
Spring Boot 整合 CXF，@WebServiceRef 注入失败，提示 “No qualifying bean”
因为 @WebServiceRef 是 JAX-WS 规范注解，Spring 并不原生支持自动注入 CXF 客户端 Bean，它只处理 @Autowired。
立即学习“Java免费学习笔记（深入）”；
- 不要用
@WebServiceRef，改用@Autowired注入你手动声明的JaxWsProxyFactoryBean或生成的 Service 接口实现类 - 正确方式：在
@Configuration类里定义@Bean，用JaxWsProxyFactoryBean创建客户端，并设setAddress和setServiceClass - 如果用
cxf-spring-boot-starter，确保版本匹配 Spring Boot 版本（如 Boot 3.x 要用 CXF 4.0+），否则CxfAutoConfiguration不生效 - 生成的 Service 类有
getServiceName()和getPortName()，调试时可打印出来，确认是否和 WSDL 中的service/port名字一致
wsdl2java 参数都没用。WSDL 文件本身是否含 import 或 include 外部 XSD，也会影响生成结果，这些细节比语法更常导致失败。 
