WSO2数据服务接收GZIP压缩JSON时触发I/O异常求助

问题根源 #

错误中的Invalid UTF-8 start byte 0x8b是核心线索——0x8b是GZIP压缩数据的起始标识字节，说明WSO2 Micro Integrator未自动解压GZIP压缩的请求体，而是直接将二进制压缩数据当作UTF-8文本解析，导致字符转换异常。

解决步骤 #

1. 开启Micro Integrator的GZIP解压支持

在MI的deployment.toml文件中添加以下配置，启用传输层的GZIP解压功能：

[transport.http.parameters]
"deflate.enable" = true
"gzip.enable" = true

2. 确保请求头正确传递

客户端发送请求时必须携带Content-Encoding: gzip请求头，告知服务端请求体为GZIP压缩格式。若通过API Manager转发请求：

• 检查API的头过滤规则，确保Content-Encoding头未被拦截或移除，默认配置下该头会被传递，若有自定义规则需添加允许该头。

3. 验证DataService配置

如果DataService为REST类型，确认其输入类型配置为application/json，确保服务端能正确处理解压后的JSON数据。

4. 重启服务

修改deployment.toml后，重启WSO2 Micro Integrator使配置生效。

额外排查点

• 若API Manager配置了自定义序列，检查序列中是否存在修改或移除Content-Encoding头的逻辑，确保该头能完整传递到后端DataService。
• 可直接向Micro Integrator的DataService发送GZIP压缩请求（跳过API Manager），排查是否为AM转发环节的问题。

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