解析外部傳來的 JSON 時,最常踩到的地雷就是「這個欄位不一定存在」。以微信授權為例,snsapi_base 類型的回傳通常沒有 refresh_token,而需要重新授權的場景則會有。若直接呼叫 getString(),就會拿到 null 或拋出異常。
正確做法是先檢查 key 是否存在,再決定要不要取值:
public static void main(String[] args) throws Exception {
String jsonStr1 = "{\"access_token\":\"OezXcEiiBSKSxW0eoylIeIVb08lFhyeFsq6cUJJNo8XYLoJjqYARJOZUrnqhfvnyMKOSjz5SHPHGUmt6f09_762MWQ0HLnZtffDPyD2A6TgCqWlZAEsHLhIaaQVYx1lywxOWQTrr7rX13i_w1INGnw\",\"expires_in\":7200,\"openid\":\"owYTUs68SXYX83wBvm_uN4Ya****\",\"scope\":\"snsapi_base\"}";
String jsonStr2 = "{\"access_token\":\"OezXcEiiBSKSxW0eoylIeIVb08lFhyeFsq6cUJJNo8XYLoJjqYARJOZUrnqhfvnyMKOSjz5SHPHGUmt6f09_762MWQ0HLnZtffDPyD2A6TgCqWlZAEsHLhIaaQVYx1lywxOWQTrr7rX13i_w1INGnw\",\"expires_in\":7200,\"refresh_token\":\"OezXcEiiBSKSxW0eoylIeIVb08lFhyeFsq6cUJJNo8XYLoJjqYARJOZUrnqhfvnyuq9ojibRxolf9ElS7PSM0Kz1OTNlJ8ZKJl2BfbPi0LA-nQ9uNVUE8ujLFsdCeP79_L9FmIYcmHLXWXnl-fUsVg\",\"openid\":\"owYTUs68SXYX83wBvm_uN4Y****\",\"scope\":\"snsapi_base\"}";
JSONObject json1 = JSONObject.fromObject(jsonStr1);
JSONObject json2 = JSONObject.fromObject(jsonStr2);
String refresh_token_1 = null;
String refresh_token_2 = null;
if (json1.containsKey("refresh_token")) {
refresh_token_1 = json1.getString("refresh_token");
}
if (json2.containsKey("refresh_token")) {
refresh_token_2 = json2.getString("refresh_token");
}
System.out.println(refresh_token_1);
System.out.println(refresh_token_2);
}
執行結果:
null OezXcEiiBSKSxW0eoylIeIVb08lFhyeFsq6cUJJNo8XYLoJjqYARJOZUrnqhfvnyuq9ojibRxolf9ElS7PSM0Kz1OTNlJ8ZKJl2BfbPi0LA-nQ9uNVUE8ujLFsdCeP79_L9FmIYcmHLXWXnl-fUsVg
第一筆沒有 refresh_token,因此輸出 null;第二筆則正常取到值。這正好驗證了 containsKey() 的必要性。
補充一點:除了 containsKey(),實務上也常見 optString("refresh_token", "") 這種寫法——它會在 key 不存在時回傳你指定的預設值,程式碼更精簡。兩種方式都可以,重點是不要假設欄位一定存在。這類防禦性寫法在處理第三方 API 回應時尤其重要,因為對方的回傳格式往往會隨版本或權限範圍而變動。