Karate框架中Multipart请求默认添加charset=UTF-8的问题分析

在自动化测试框架Karate中，开发者使用multipart/form-data上传文件时，框架会默认在Content-Type头中附加charset=UTF-8参数。这一行为虽然符合HTTP协议规范，但在某些特定场景下（如上传Excel文件）可能导致服务端兼容性问题。

问题现象

当开发者显式指定Content-Type为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet时，实际发出的请求会被自动修改为：

Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet; charset=UTF-8

技术背景

Karate底层基于Netty的HttpPostRequestEncoder处理multipart请求，其构造函数默认会强制添加UTF-8字符集：

this.encoder = new HttpPostRequestEncoder(..., CharsetUtil.UTF_8, ...);

这种设计确保了文本数据的正确编码，但对于二进制文件传输场景可能显得多余。

解决方案

目前官方推荐的解决方式是通过配置关闭字符集自动添加：

* configure charset = null

但需要注意：

1. 该配置对multipart请求可能不完全生效
2. 全局关闭可能影响其他文本请求的编码处理

深入建议

对于需要精确控制Content-Type的场景，开发者可以考虑：

1. 直接使用Java互操作性实现自定义上传逻辑
2. 等待框架未来版本提供更细粒度的字符集控制
3. 在服务端做兼容性处理，同时接受带和不带字符集的Content-Type

该问题反映了自动化测试工具在处理协议细节时需要平衡严格性和灵活性的挑战。理解框架的底层实现机制有助于开发者找到最适合自身测试场景的解决方案。