Java模拟表单文件上传(微信/中文名乱码问题)

雨点打透心脏的1/2处 2022-09-22 13:56 189阅读 0赞

> 最近在做微信企业号，在上传素材文件时遇到了点问题，主要是中文文件名乱码的问题，开始使用的是httpclient3.x的api去实现，文件上传没问题，就是名称是中文的时候死活都是乱码，自己也设置了很多地方的编码为utf-8，也没有用，后来百度，谷歌，也没有找到解决方案，或许解决方案是有效的，但是到了微信这边就没有用了，后来干脆使用HttpURLConnection解决了问题，另外经过半天鼓捣，也解决了一些其他相关性的问题，对文件上传也有了更深的了解。不过后面用httpclient4.x试了一下，发现也是可以解决问题的。

## **Http请求** ##

自己写了一个表单，上传文件，提交表单，查看http请求，可以看到。

------WebKitFormBoundary7blBEBTiZtWOX8LI
    Content-Disposition: form-data; name="id"
    
    
    ------WebKitFormBoundary7blBEBTiZtWOX8LI
    Content-Disposition: form-data; name="msgtype"
    
    file
    ------WebKitFormBoundary7blBEBTiZtWOX8LI
    Content-Disposition: form-data; name="uploadImage"; filename="0.png"
    Content-Type: image/png
    
    
    ------WebKitFormBoundary7blBEBTiZtWOX8LI--

表单设置成multipart/form-data之后表单内容就变成上面的格式了，如上表单中有两个属性id,msgtype，其中id内容为空，msgtype值为file，然后还有一个文件，  
**Content-Disposition: form-data; name=”uploadImage”; filename=”0.png”**  
其中name是input file 的name值，filename是文件名，注意模拟表单提交的时候，filename必须要有值，而且是要带后缀的，否则提交不成功。

## **HttpURLConnection实现表单文件提交** ##

这里使用的IOUtils是commons.io的包，也是直接使用close关闭流

/** * 模拟上传文件(远程URL) * * @Title uploadFile * @param uploadUrl 上传路径 * @param picUrl 远程图片URL * @param params 参数内容 * @return * @throws IOException * @author zh * @date 2016年6月30日 下午4:22:10 */
        public static String uploadFile(String uploadUrl, URL picUrl, Map<String,String> params) throws IOException {
            return uploadFile(uploadUrl, picUrl.openStream(), picUrl.getFile().substring(picUrl.getFile().lastIndexOf("/")) + 1, params);
        }
    
        /** * 模拟上传文件(本地文件) * * @Title uploadFile * @param uploadUrl 上传路径 * @param picUrl 本地文件 * @param params 参数内容 * @return * @throws IOException * @author zh * @date 2016年6月30日 下午4:23:15 */
        public static String uploadFile(String uploadUrl, File file, Map<String,String> params) throws IOException {
            return uploadFile(uploadUrl, new FileInputStream(file), file.getName(), params);
        }
    
        /** * 模拟上传文件（输入流） * * @Title uploadFile * @param uploadUrl 上传链接 * @param is 输入流 * @param filename 文件名 * @param params 参数 * @return * @throws IOException * @author zh * @date 2016年6月30日 下午4:08:52 */
        public static String uploadFile(String uploadUrl, InputStream is, String filename, Map<String,String> params) throws IOException {
            URL urlGet = new URL(uploadUrl);
            HttpURLConnection conn = (HttpURLConnection) urlGet.openConnection();
            conn.setDoOutput(true);
            conn.setDoInput(true);
            conn.setUseCaches(false);
            conn.setRequestMethod("POST");
            conn.setRequestProperty("connection", "Keep-Alive");
            conn.setRequestProperty("user-agent", DEFAULT_USER_AGENT);  
            conn.setRequestProperty("Charsert", "UTF-8");
            // 定义数据分隔线
            String BOUNDARY = "----WebKitFormBoundary7blBEBTiZtWOX8LI"; 
            conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + BOUNDARY);
    
            OutputStream out = new DataOutputStream(conn.getOutputStream());
            // 文件内容
            StringBuilder contentBody = new StringBuilder();
            contentBody.append("--").append(BOUNDARY).append("\r\n");
            contentBody.append("Content-Disposition: form-data;name=\"media\";filename=\""+ filename + "\"\r\n");
            contentBody.append("Content-Type:application/octet-stream\r\n\r\n");
            System.out.println(contentBody);
            out.write(contentBody.toString().getBytes());
            DataInputStream fs = new DataInputStream(is);
            int bytes = 0;  
            byte[] bufferOut = new byte[1024];
            while ((bytes = fs.read(bufferOut)) != -1) {
                out.write(bufferOut, 0, bytes);
            }
            IOUtils.closeQuietly(fs);
            // 参数内容
            if (params != null && params.size() > 0) {
                for (String key : params.keySet()) {
                    StringBuilder paramData = new StringBuilder();
                    paramData.append("\r\n").append("--").append(BOUNDARY).append("\r\n");
                    paramData.append("Content-Disposition: form-data;name=\""+key+"\";");
                    paramData.append("\r\n");
                    paramData.append("\r\n");
                    paramData.append("\""+params.get(key)+"\"");
                    System.out.println(paramData);
                    out.write(paramData.toString().getBytes());
                }
            }
            // 最后一个片段结尾要用--表示
            byte[] end_data = ("\r\n--" + BOUNDARY + "--\r\n").getBytes();
            out.write(end_data);
            out.flush();
            IOUtils.closeQuietly(out);
    
            // 定义BufferedReader输入流来读取URL的响应 
            InputStream in = conn.getInputStream();
            BufferedReader read = new BufferedReader(new InputStreamReader(in, Charsets.UTF_8));
            String valueString = null;
            StringBuffer bufferRes = null;
            bufferRes = new StringBuffer();
            while ((valueString = read.readLine()) != null){
                bufferRes.append(valueString);
            }
            IOUtils.closeQuietly(in);
            // 关闭连接
            if (conn != null) {
                conn.disconnect();
            }
            return bufferRes.toString();
        }

## **微信企业号上传临时素材** ##

*  请求说明  
    Https请求方式: POST

[https://qyapi.weixin.qq.com/cgi-bin/media/upload?access\_token=ACCESS\_TOKEN&type=TYPE][https_qyapi.weixin.qq.com_cgi-bin_media_upload_access_token_ACCESS_TOKEN_type_TYPE]

*  参数说明  
    参数 必须 说明  
    ![这里写图片描述][20160630163002922]  
    权限说明  
    完全公开。所有管理组均可调用，media\_id可以共享。

返回说明

{
       "type": "image",
       "media_id": "1G6nrLmr5EC3MMb_-zK1dDdzmd0p7cNliYu9V5w7o8K0",
       "created_at": "1380000000" }

说实话，微信的文档有些地方做的真的不怎么样，而且企业号现在功能也不是太全，比如SaaS套件第三方应用有授权安装的API，却没有取消授权安装的API，有些东西值要调几个API才可以得到，可能他们有他们的考虑吧，不说了，继续说遇到的问题。  
使用上面这种方法调用上传素材，然后得到media\_id去发送消息，发送文件的时候，如果是中文名的文件，也不会出现乱码了，当然这个上传文件不仅是在微信的时候用，平时需要的各种环境都可以使用，这里拿微信只是举例，如果要使用httpclient，那还是推荐使用httpclient4.x以上的版本吧，貌似这个解决方案多一点。

## **上传文件** ##

public static void main(String[] args) throws Exception {
            File file = new File("E:\\中文图片.jpg");
            String access_token = "AasbMO9SCcF3HO0jVLnddQuZo4pUmSYHieqC56vQbBvQgqGWW8spQG5CtWT6Vcjh";
            String uploadUrl = "https://qyapi.weixin.qq.com/cgi-bin/media/upload?type=file&access_token="+ CommonUtil.encode(access_token);
            // 本地文件
            String upload_response = uploadFile(uploadUrl, file, null);
            System.out.println(upload_response);
    
            // 远程URL文件提交上传
            URL url = new URL("http://www.baidu.com/xx/xxx.zip");
            String upload_response2 = uploadFile(uploadUrl, url, null);
            System.out.println(upload_response2);
        }

## 小结 ##

> 这里走了很多弯路，因为在前台页面不可能带上Access\_token，为了安全，只能先将文件上传到服务器，然后发送请求到微信，这里就出现了一个问题，服务器是linux的，中文名的文件会乱码，起初是统一替换文件名为一串时间戳的字符，但是在发送消息，类型为文件时，会显示文件名，这样不好，所以必须要显示原文件名，原以为必须要再本地存一份，然后提交给微信，后来发现，远程URL，文件流都可以提交，所以问题就好解决了，本地不需要存了，然后得到文件流，然后得到原文件名，推送给微信，上面给出的三个版本，本地文件，远程URL，文件流的实现版本，总体还是解决了这个问题。

## **多文件上传版本** ##

private static final String DEFAULT_USER_AGENT = "Mozilla/5.0 (Windows NT 6.3; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/33.0.1750.146 Safari/537.36";
    /** * 模拟上传文件请求 * * @Title uploadFile * @param uploadUrl 上传url * @param files 文件列表 * @param params 参数列表 * @return * @throws Exception * @author zh * @date 2016年6月30日 下午3:54:26 */
        public String uploadFile(String uploadUrl, List<File> files, Map<String,String> params) throws Exception {
            String BOUNDARY = "----WebKitFormBoundary7blBEBTiZtWOX8LI";
            String response = "";
            HttpURLConnection conn = null;  
            try { 
                URL url = new URL(uploadUrl);
                conn = (HttpURLConnection) url.openConnection();
                conn.setDoOutput(true);
                conn.setDoInput(true);
                conn.setUseCaches(false);
                conn.setRequestMethod("POST");
                conn.setRequestProperty("Connection", "Keep-Alive");
                conn.setRequestProperty("Charset", "UTF-8");
                conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + BOUNDARY);
                StringBuffer contentBody = new StringBuffer();
                OutputStream out = new DataOutputStream(conn.getOutputStream());
                if (params != null && params.size() > 0) {
                    for (String key : params.keySet()) {
                        contentBody.append("\r\n").append("--").append(BOUNDARY).append("\r\n");
                        contentBody.append("Content-Disposition: form-data; name=\"").append(key + "\"");
                        contentBody.append("\r\n").append("\r\n").append(params.get(key)).append("\r\n");
                    }
                }
                System.out.println(contentBody);
                out.write(contentBody.toString().getBytes("utf-8"));
                if(files != null && files.size() > 0){
                    for (File file : files) {
                        contentBody = new StringBuffer();
                        contentBody.append("\r\n").append("--").append(BOUNDARY).append("\r\n");
                        contentBody.append("Content-Disposition:form-data; name=\"")
                                .append("media\"; ").append("filename=\"").append(file.getName() + "\"")
                                .append("\r\n" + "Content-Type:application/octet-stream")
                                .append("\r\n" + "Content-Transfer-Encoding: binary" + "\r\n" + "\r\n");
                        System.out.println(contentBody.toString());
                        out.write(contentBody.toString().getBytes("utf-8"));
                        DataInputStream dis = new DataInputStream(new FileInputStream(file));
                        int bytes = 0;  
                        byte[] bufferOut = new byte[1024];  
                        while ((bytes = dis.read(bufferOut)) != -1) {  
                            out.write(bufferOut, 0, bytes);  
                        }  
                        dis.close();
                    }
                }
                byte[] endData = ("\r\n--" + BOUNDARY + "--\r\n").getBytes();  
                out.write(endData);  
                out.flush();  
                out.close();  
    
                // 读取返回数据 
                StringBuffer strBuf = new StringBuffer();  
                BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()));  
                String line = null;  
                while ((line = br.readLine()) != null) {  
                  strBuf.append(line).append("\n");  
                }  
                response = strBuf.toString();  
                br.close();  
             } catch (Exception e) {  
                System.out.println("发送POST请求出错。" + uploadUrl);  
                e.printStackTrace();  
            } finally {  
                if (conn != null) {  
                    conn.disconnect();  
                    conn = null;  
                }  
            }  
            return response;
        }

## **HttpClient3 实现文件上传版本** ##

public String uploadFile(String uploadUrl, List<File> files, Map<String,String> params) throws Exception {
            HttpClient client = new HttpClient();
            PostMethod httpPost = new PostMethod(uploadUrl);
            httpPost.setRequestHeader("User-Agent", "AdUU");
            httpPost.setRequestHeader("Accept-Language", "zh-cn,zh;q=0.5");
            httpPost.setRequestHeader("Accept-Charset", "GBK,utf-8;q=0.7,;q=0.7");
            httpPost.setRequestHeader("Connection", "keep-alive");
            ArrayList<PartBase> parts = new ArrayList<PartBase>();
            if (params != null && params.size() > 0) {
                for (String key : params.keySet()) {
                    parts.add(new StringPart(key, params.get(key)));
                }
            }
            if (files != null && files.size() > 0)
                for (File file : files) {
                    parts.add(new FilePart("upload",file.getName(), file));
                }
            httpPost.setRequestEntity(new MultipartRequestEntity(parts.toArray(new Part[]{}), httpPost.getParams()));
            client.executeMethod(httpPost);
            StringBuilder response = new StringBuilder();
            if (httpPost.getStatusCode() == 200) {
                BufferedReader reader = new BufferedReader(
                        new InputStreamReader(httpPost.getResponseBodyAsStream(), "UTF-8"));
                String line;
                while ((line = reader.readLine()) != null) {
                    response.append(line);
                }
                reader.close();
            }
            return response.toString();
        }

> 最后说一点，如果是实现微信上传的话， 最好还是使用HttpURLConnection版本，或者用httpclient4.x以上版本，这样就解决了中文文件名上传的问题。

## **HttpClient4.x 解决微信上传素材中文名乱码问题** ##

测试通过版本：

*  httpclient 4.5.2
 *  httpcore 4.4.4
 *  httpmime 4.5.2

import java.io.File;
    import java.io.IOException;
    import java.util.ArrayList;
    import java.util.List;
    import java.util.Map;
    
    import org.apache.http.Consts;
    import org.apache.http.HttpEntity;
    import org.apache.http.client.methods.CloseableHttpResponse;
    import org.apache.http.client.methods.HttpPost;
    import org.apache.http.entity.ContentType;
    import org.apache.http.entity.mime.HttpMultipartMode;
    import org.apache.http.entity.mime.MultipartEntityBuilder;
    import org.apache.http.impl.client.CloseableHttpClient;
    import org.apache.http.impl.client.HttpClients;
    import org.apache.http.util.EntityUtils;
    
    public class Upload { 
    
        public static String uploadFile(String uploadUrl, List<File> files, Map<String,String> params) {
            CloseableHttpClient httpclient = HttpClients.createDefault();
            CloseableHttpResponse response = null;
            HttpEntity entity = null;
            String result = "";
            try{
                HttpPost httpPost = new HttpPost(uploadUrl);
                httpPost.setHeader("User-Agent", "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2723.3 Safari/537.36");
                httpPost.setHeader("Accept-Language", "zh-cn,zh;q=0.5");
                httpPost.setHeader("Accept-Charset", "UTF-8,utf-8;q=0.7,;q=0.7");
                httpPost.setHeader("Connection", "keep-alive");
    
                MultipartEntityBuilder multipartEntityBuilder = MultipartEntityBuilder.create();
                // 这里是解决中文名乱码的关键，很多地方说设置HttpMultipartMode.BROWSER_COMPATIBLE，到微信这里就不行了
                multipartEntityBuilder.setMode(HttpMultipartMode.RFC6532);
                // 这里是个坑，乱码问题首先想到的是设置编码，可是设置这个之后，微信就报41005错误了。大坑大坑。。具体原因我也不清楚
    // multipartEntityBuilder.setCharset(Consts.UTF_8);
                if(params != null && params.size() > 0){
                    for (Map.Entry<String, String> entry : params.entrySet()) {
                        multipartEntityBuilder.addTextBody(entry.getKey(), entry.getValue().toString(), ContentType.create("text/plain", Consts.UTF_8));
                    }
                }
                if (files != null && files.size() > 0){
                    for (File file : files) {
                        multipartEntityBuilder.addBinaryBody("media", file);
                    }
                }
                httpPost.setEntity(multipartEntityBuilder.build());
    
                response = httpclient.execute(httpPost);
                entity = response.getEntity();
                if (response.getStatusLine().getStatusCode() == 200) {
                    result = EntityUtils.toString(response.getEntity());
                }
            }catch(Exception e){
                e.printStackTrace();
            }finally{
                try {
                    if(entity != null){
                        EntityUtils.consume(entity);
                    }
                    if(response != null){
                        response.close();
                    }
                    if(httpclient != null){
                        httpclient.close();
                    }
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
            return result;
        }
    
        public static void main(String[] args) {
            String access_token = "1zavF25bdA-bunJWhbfM0TNdJyrfonKpCLwBk--TllY232BFXVcCapnNNTAigasb";
            List<File> files = new ArrayList<File>();
            files.add(new File("E:\\中文.txt"));
            String result = uploadFile("https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token="+access_token+"&type=file", files, null);
            //{"type":"file","media_id":"1cn4gBj-jg6phmUZSqqRjbOYye56CdgPaTmgunfJ7yvhW44yaD-Py0mbA9lyZ6Ckhjli9JKIKibFv8kq385eWhg","created_at":1468382218}
            System.out.println(result);
        }
    
    }

注释部分是重点，网上很多解决方案都试过了，不行，首先想到的是设置编码，结果反而导致上传文件不成功了，微信返回41005之类的错误代码，很多地方说设置**HttpMultipartMode.BROWSER\_COMPATIBLE**，到微信这里就不行了，所以解决中文名乱码的关键代码是**multipartEntityBuilder.setMode(HttpMultipartMode.RFC6532);**这样上传素材之后拿到的media\_id然后去发送消息的时候，中文名就不会乱码了。

[https_qyapi.weixin.qq.com_cgi-bin_media_upload_access_token_ACCESS_TOKEN_type_TYPE]: https://qyapi.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE
[20160630163002922]: /images/20220721/d98f660bc17344efb976ef95c9759673.png