启用SSL后Java服务报Unable to create StAX reader or writer异常如何解决

com.sun.xml.ws.protocol.soap.MessageCreationException: Couldn't create SOAP message due to exception: Unable to create StAX reader or writer是Java服务端JAX-WS组件解析SOAP报文失败抛出的错误，仅SSL场景下部分请求报错的核心原因是SSL层传输特性导致服务端拿到的输入流不完整/非连续，常见触发场景如下：

• 异常请求大小刚好触发TLS记录分片：当SOAP报文大小超过TLS记录的默认最大长度（通常是16KB）时，报文会被拆分为多个TLS数据包传输，部分低版本JAX-WS实现不会等待完整报文重组完成，就直接将不完整的输入流交给StAX解析器，直接触发读写器创建失败
• C#端分块传输与SSL的兼容问题：部分版本的.NET HttpClient/HttpWebRequest在发送超过特定大小的HTTPS请求时，会自动启用Transfer-Encoding: chunked分块传输，低版本JAX-WS对SSL+分块传输的组合处理存在已知bug，无法正确识别分块边界，导致解析到截断的报文
• 服务端HTTPS缓冲配置不足：服务端Web容器的HTTPS连接器缓冲大小配置过小，对于超过缓冲阈值的请求，会直接将未读完的流抛给上层解析组件
• 多字节字符跨分片拆分：如果SOAP报文中包含UTF-8多字节字符，且该字符刚好被拆分到两个TLS分片中，部分严格校验编码的StAX实现会直接抛出解析异常

• 先确认异常请求的共性：统计所有报错请求的大小、是否包含中文等多字节字符、是否携带SOAP附件，确认是否只有超过特定大小阈值的请求会触发异常
• 抓包对比报文完整性：分别在C#客户端、Java服务端抓包，解密TLS流量后，对比客户端发送的原始SOAP报文和服务端接收到的报文内容是否完全一致，确认是否存在报文截断、内容丢失的情况
• 验证版本兼容性：确认服务端使用的JAX-WS（Metro）版本，查询该版本是否存在SSL场景下输入流解析的已知bug
• 临时禁用分块传输测试：在C#端强制关闭分块传输，设置HttpWebRequest.SendChunked = false，提前计算并携带Content-Length请求头发送，验证异常是否消失
• 替换输入流验证：在服务端添加Filter拦截HTTPS请求，先将完整请求体读取到字节数组，再封装为ByteArrayInputStream传给后续逻辑，如果异常消失即可确认是输入流读取不完整导致的问题

• 升级服务端JAX-WS组件到2.3.1及以上稳定版本，修复SSL场景下输入流预读取不足的已知bug
• 调整服务端Web容器HTTPS连接器配置，以Tomcat为例，调整server.xml中HTTPS连接器的参数：bufferSize="65536"、maxSwallowSize="-1"，确保缓冲大小能容纳最大的请求报文
• 无法升级依赖时可添加自定义拦截逻辑：在服务端SOAP解析前添加拦截器，先完整读取整个请求体到内存，再将封装后的字节流交给JAX-WS解析，避免StAX读取不完整的分片流
• 客户端侧禁用HTTPS分块传输，发送请求时固定携带Content-Length头，避免服务端分块解析异常

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