httpServletRequest.getParameter 参数中存在“&”导致获取不到完整参数的问题

记录最近遇到的坑。

起因

账管有个信用卡绑定接口，我的调用的时候需要传号码、地址等信息，使用的是 HttpURLConnection，发送的时候将参数转为key=value&key=value 的形式，账管那边使用 httpServletRequest.getParameter() 进行获取参数。
问题就是当某些地址中存在 & 符号的时候，因为账管获取参数的时候是通过 & 符号进行截取的，就会导致他们获取参数不全。
如：a=123&b=park&center
本来 b 的 value 应该是 park&center，现在他们那边只能获取到 park，这就导致两边参数不一样，签名也不一样，然后验签失败。

解决方案

以上就是事情的起因，期初我的建议是他们那边能不能换成 json 格式的接收，我们这边直接发送 json 格式的数据，这样应该不会有问题，但是他们死活不愿意改。
后续方案是我们将参数中的 & 进行 URL 编码，将其转化为 %26。

我们实现的方法大概如下：

    public String pay(String url, Map<String, String> params) {
        URL u = null;
        HttpURLConnection con = null;
        // 构建请求参数
        StringBuffer sb = new StringBuffer();
        String strResult = null;
        if (params != null) {
            for (Entry<String, String> e : params.entrySet()) {
                sb.append(e.getKey());
                sb.append("=");                
                sb.append(e.getValue());
                sb.append("&");
            }
            strResult = sb.substring(0, sb.length() - 1);
        }
        
        // 尝试发送请求
        try {
            u = new URL(url);
            con = (HttpURLConnection) u.openConnection();
            // POST 只能为大写，严格限制，post会不识别
            con.setRequestMethod("POST");
            con.setDoOutput(true);
            con.setDoInput(true);
            con.setUseCaches(false);
            con.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
            OutputStreamWriter osw = new OutputStreamWriter(con.getOutputStream(), "UTF-8");
            osw.write(sb.toString());
            osw.flush();
            osw.close();
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            if (con != null) {
                con.disconnect();
            }
        }
        // 读取返回内容
        StringBuffer buffer = new StringBuffer();
        try {
            //一定要有返回值，否则无法把请求发送给server端。
            BufferedReader br = new BufferedReader(new InputStreamReader(con.getInputStream(), "UTF-8"));
            String temp;
            while ((temp = br.readLine()) != null) {
                buffer.append(temp);
            }
        } catch (Exception e) {
            logger.error("*****报错：", e);
        }

        return buffer.toString();
    }

改造为：

                String value = e.getValue();
                if (value.contains("&")) {
                    try {
                        // URL编码,针对“&”进行处理，防止截取参数不完整导致验签失败
                        value = URLEncoder.encode(value, "UTF-8");
                    } catch (UnsupportedEncodingException e1) {
                        e1.printStackTrace();
                    }
                }
                sb.append(value);

分析原因

使用 httpServletRequest.getParameter 接收post请求参数，发送端 content Type 必须设置为 application/x-www-form-urlencoded；否则会接收不到

使用 httpServletRequest.getParameter 也是获取不到 json 格式的数据的，发送端只能发送 key=value&key=value 格式的数据。所以如果需要发送 json 格式的数据，两边都需要进行改造。

application/x-www-form-urlencoded 通过表单提交，在sevlet实现中，mutipart/form-data 和 application/x-www-form-urlencoded 会被特殊处理，请求参数将被放置于 request.paramter，这是一个map。
我们可以从map中获取参数进行验证，或者其他拦截需求，map的获取类似hibernate的延迟加载，当调用 request.getparamter(） 方法，servlet才会从请求流中读取请求参数加载入map。InputStream 也会存有这份数据，但如果这份数据被读取，那么到了controller层将无法读出数据，同样，拦截之后到达controller层时请求数据已经被加载入了controller层方法实参，实参对象需要有set方法，框架会以反射的方式调用属性的set方法注入数据，数据只会被注入到已有的属性。

当以 application/json 的 content-type 传送数据，被传送的对象只需被json序列化。当以 application/x-www-form-urlencoded 的方式传送数据。请求的内容需要以…=…&…=…的格式提交，在请求体内内容将会以”&”和“ = ”进行拆分。