升级Apache CXF至3.6.4后出现Unsupported protocolTLS异常求助

异常信息 #

javax.ws.rs.ProcessingException: java.io.IOException: IOException invoking <URL>: java.lang.IllegalArgumentException: Unsupported protocolTLS
at org.apache.cxf.jaxrs.client.AbstractClient.checkClientException(AbstractClient.java:645)
...
Caused by: java.lang.IllegalArgumentException: Unsupported protocolTLS
    at sun.security.ssl.ProtocolVersion.namesOf(ProtocolVersion.java:292)
    ...

问题背景 #

将Apache CXF从3.5.9版本升级至3.6.4后，发起HTTPS请求时触发上述异常。原3.5.9版本无此问题，已确认服务器支持TLSv1.2，应用明确配置使用TLSv1.2，仅升级依赖未修改代码。

已尝试操作 #

• 使用外部工具验证服务器支持TLSv1.2；
• 确认JVM（Java 11）支持TLSv1.2；
• 查阅Apache CXF发布说明，未找到协议或SSL配置相关变更；
• 确认相同配置在CXF 3.5.9中可正常运行。

环境信息 #

• Apache CXF：3.6.4（原版本3.5.9）
• Java：11
• 框架：Spring Boot 2.x
• 协议：HTTPS（基于TLSv1.2）

解决思路与步骤 #

根因分析 #

异常提示的Unsupported protocolTLS说明配置中存在格式错误的协议名称——正确的协议标识应为TLS或TLSv1.2，而非拼接错误的protocolTLS。CXF 3.6.x版本对SSL协议配置的解析逻辑做了更严格的校验，移除了3.5.9版本中的容错机制，导致原本被忽略的错误配置触发异常。

修正步骤 #

1. 排查并修正SSL协议配置

   • 若为代码配置：检查是否存在类似setProtocols(new String[]{"protocolTLS"})的错误写法，修改为"TLSv1.2"或"TLS"；
   • 若为配置文件（如application.properties/application.yml）：查找是否有cxf.ssl.protocols=protocolTLS这类配置，修正为cxf.ssl.protocols=TLSv1.2。

2. 校验CXF客户端SSL工厂配置
   若使用HTTPConduit或TLSClientParameters配置SSL，确保协议名称正确：

   TLSClientParameters tlsParams = new TLSClientParameters();
   tlsParams.setSecureSocketProtocol("TLSv1.2"); // 此处必须使用标准协议名
   HTTPConduit httpConduit = (HTTPConduit) ClientProxy.getClient(yourService).getConduit();
   httpConduit.setTlsClientParameters(tlsParams);
   

3. 验证修复效果
   修改配置后重启应用，发起HTTPS请求，确认异常是否消除。

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