本文详解如何识别并正确解压 GZIP/Deflate 压缩的 SOAP 响应，避免因忽略 Content-Encoding 导致的 XML 乱码问题，确保 Java 原生 HTTP 客户端能解析可读的 XML。
本文详解如何识别并正确解压 gzip/deflate 压缩的 soap 响应，避免因忽略 `content-encoding` 导致的 xml 乱码问题，确保 java 原生 http 客户端能解析可读的 xml。
在 Java 中直接使用 HttpURLConnection 调用 SOAP Web 服务时，若服务端启用了响应压缩（如 gzip 或 deflate），而客户端未主动解压，就会收到一串不可读的二进制乱码（如 \_\_ 开头的字节流），而非结构清晰的 XML。虽然该服务在 SoapUI 中正常工作（因其内置自动解压逻辑），但原生 Java 代码需显式处理压缩流。
核心解决思路是：检查 HTTP 响应头中的 Content-Encoding 字段，并根据其值对 InputStream 进行相应解压封装。以下是优化后的关键代码段（已整合至完整方法中）：
// 发送请求后，获取响应流
InputStream inputStream = httpConn.getInputStream();
String contentEncoding = httpConn.getContentEncoding();
// 根据 Content-Encoding 自动选择解压方式
if ("gzip".equalsIgnoreCase(contentEncoding)) {
inputStream = new GZIPInputStream(inputStream);
} else if ("deflate".equalsIgnoreCase(contentEncoding)) {
inputStream = new InflaterInputStream(inputStream);
}
// 统一以 UTF-8 解码，确保中文与特殊字符正确显示
InputStreamReader isr = new InputStreamReader(inputStream, StandardCharsets.UTF_8);
BufferedReader reader = new BufferedReader(isr);
StringBuilder responseBuilder = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) {
responseBuilder.append(line);
}
String rawResponse = responseBuilder.toString();
// 可选：格式化 XML（需自行实现 formatXML 方法）
String formattedXML = formatXML(rawResponse);⚠️ 注意事项与最佳实践：
- 必须校验 contentEncoding 是否为 null：部分服务未返回该头，直接解压会抛出 ZipException；
- 优先使用 StandardCharsets.UTF_8 替代 Charset.forName("UTF-8")：更安全、无异常风险；
- 避免 responseString += ... 拼接：改用 StringBuilder 提升大响应体性能；
- 关闭资源：实际生产代码中应使用 try-with-resources 管理 InputStream、Reader 等资源；
- SOAPAction 头不可省略：尤其对 .asmx 服务，缺失将导致 500 错误；
- HTTPS 场景需额外配置 SSLContext：文中 fixHttpsHandler() 需确保信任证书或跳过验证（仅限测试环境）。
最终，经解压与 UTF-8 解码后的 rawResponse 即为标准 SOAP XML 字符串，可直接交由 DocumentBuilder 解析，或传入 JAXB、Apache CXF 等框架进一步反序列化为 Java 对象。此方案兼容 JDK 8+，无需引入第三方 HTTP 库，兼顾轻量性与可靠性。
立即学习“Java免费学习笔记（深入）”；
