okhttp3 請求頭不能為中文的坑

對原始碼有一定的瞭解，以為基本可以駕馭了，誰知道，坑來了。

問題描述：

上線介面的某一天，有使用者報障，說登入不上，而且陸續有報障。

通過log 發現登入不上，都有一個類似的報錯：
“java.lang.IllegalArgumentException: Unexpected char 0x514d at 4 in wifiSsid value: "360免費WiFi-DP" at ”

什麼？怎麼和wifiSsid有關係了？後來查了一下程式碼，發現確實在登入介面上通過請求頭的形式上傳了 wifissid, 也就是連線的wifi的名字。Exception描述是第四個 char ，也就是“免”字？難道是因為中文的原因？當時是這麼猜測的。

原始碼查詢

猜測並不能作為判斷的標準，然後做了一下測試，果然連線含義中文名字的wifi就有問題，也就是不能新增中文到請求頭裡面。這是為什麼呢？最後還是通過原始碼進行的求證：

在okhttp的原始碼Header.java，發現set 和add header, 都會有這個判斷：

    private void checkNameAndValue(String name, String value) {
      if (name == null) throw new NullPointerException("name == null");
      if (name.isEmpty()) throw new IllegalArgumentException("name is empty");
      for (int i = 0, length = name.length(); i < length; i++) {
        char c = name.charAt(i);
        if (c <= '\u0020' || c >= '\u007f') {
          throw new IllegalArgumentException(Util.format(
              "Unexpected char %#04x at %d in header name: %s", (int) c, i, name));
        }
      }
      if (value == null) throw new NullPointerException("value == null");
      for (int i = 0, length = value.length(); i < length; i++) {
        char c = value.charAt(i);
        if ((c <= '\u001f' && c != '\t') || c >= '\u007f') {
          throw new IllegalArgumentException(Util.format(
              "Unexpected char %#04x at %d in %s value: %s", (int) c, i, name, value));
        }
      }
    }

嗷，No，果然是這樣，踩到深坑了。無論是header的 Key 和Value都是不能含有中文的，一旦判定為有中文的出現，就會丟擲異常，中斷請求。

後面想了一下，以前使用okhttp2的時候，也有上傳相同的請求頭，為什麼就沒有這個問題呢？也同樣去檢視了一下okhttp2的原始碼，發現這個判斷是okhttp3才有的，okhttp2其實並沒有這個判斷。

解決方案：

解決方案有以下幾種：

1. 不要傳了（當然這個不符合需求）
2. 把原始碼這個地方改了（也不是太好，不知道會不會引起其他問題）
3. 把中文 encode以下（相對較好的辦法）：
   ssid = URLEncoder.encode(ssid);

總結

遇到問題不可怕，主要是要做好分析，及時解決，多做總結，避免後門再次踩同樣的坑。