HttpClient提交表单出现中文乱码的解决办法

有个项目需要为图片添加水印，本来运行得很好，但后来增加了自定义水印内容的需求，且需要支持中文，于是很简单地添加了表单描述字段“remark”，但后端解析到的字符为一连串“?”（难道水印也是满脸的懵逼？），代码如下：

HttpEntity reqEntity = MultipartEntityBuilder.create();
HttpEntity reqEntity = MultipartEntityBuilder.create()
            .setCharset(Charset.forName("UTF-8"))
            // 表单文件项
            .addPart("srcImg", bin)
            .addTextBody("remark", "大头蚁")
            .build();

上面的代码虽然明确地指定了“UTF-8”编码，但依旧无法正常工作。经过诊断，确定HttpClient默认以“ISO-8859-1”传输内容，调试上述代码的HTTP头部“Content-Type: ”，得到如下内容：

Content-Type: multipart/form-data; boundary=oxrPdfjd1I_gN4JV_jVRWQHOErbryg9MARaxoPf2; charset=UTF-8

看来问题的原因不在于HTTP请求头，那么怀疑的对象就在于”addTextBody”方法，查看其源码：

public MultipartEntityBuilder addTextBody(
        final String name, final String text, final ContentType contentType) {
    return addPart(name, new StringBody(text, contentType));
}

public MultipartEntityBuilder addTextBody(
        final String name, final String text) {
    //  每个字段都有独立的编码
    return addTextBody(name, text, ContentType.DEFAULT_TEXT);
}

果然“ContentType.DEFAULT_TEXT”引起了我的注意，继续追踪源码如下：

public static final ContentType TEXT_PLAIN = create("text/plain", Consts.ISO_8859_1);

果然还是“ISO-8859-1”搞的鬼，于是解决办法就很简单了。

解决办法一：让HttpClient编码

不使用”addTextBody”方法的缩略版本，改用其完整版本，如下：

addTextBody("remark", "大头蚁", ContentType.APPLICATION_JSON)

也可以构造自己的ContentType，如下：

//  需要引入的常量
import org.apache.http.Consts;
addTextBody("remark", "大头蚁", "text/plain")

解决办法二：自己编码

这种方法稍微复杂些，但胜在适用于所有编码，服务器端与客户端代码都需要更改，首先是客户端：

String remark = URLEncoder.encode("大头蚁", "UTF-8");

然后是服务器端：

String remark = request.getParameter("remark");
remark = URLDecoder.decode(remark, "UTF-8");

其他：JAVA图片水印乱码

当把程序部署在Linux服务器上时（Centos），出现中文乱码的原因多半是由于Linux缺少中文字体导致的，最简单有效的方法是《linux系统图片验证码乱码问题解决》。