第三方API对接实战：防御性编程与健壮性设计

1. 第三方API对接的残酷现实：从理想主义到防御性编程

作为一名经历过无数次第三方对接的老兵，我必须说：对接第三方API就像在雷区跳舞，你永远不知道下一步会踩到什么。那些看似简单的接口调用背后，隐藏着无数让人崩溃的瞬间。让我们从最基础的HTTP请求开始，看看理想与现实之间的巨大鸿沟。

理想中的API调用只需要两行代码：

java复制// 理想世界中的完美API调用
Response response = httpClient.post(apiUrl, requestData);
return response.getData();

但现实情况是，你不得不写出这样的防御性代码：

java复制// 现实世界中的防御性代码
try {
    Response response = httpClient.execute(new HttpPost(apiUrl));
    if (response.getStatusLine().getStatusCode() == 200) {
        String responseBody = EntityUtils.toString(response.getEntity());
        // 开始各种异常处理
        if (!StringUtils.isEmpty(responseBody)) {
            JSONObject json = JSON.parseObject(responseBody);
            // 处理各种可能的返回结构
            if (json.containsKey("code")) {
                Object code = json.get("code");
                // 处理不同接口的成功码差异
                boolean success = ("0".equals(code.toString()) 
                    || "SUCCESS".equals(code.toString())
                    || (code instanceof Boolean && (Boolean)code));
                // 更多字段处理...
            }
        }
    }
} catch (Exception e) {
    // 记录日志并重试或降级处理
} finally {
    // 资源清理
}

2. 数据类型陷阱：从Integer到"12.5kg"的奇幻漂流

2.1 文档与现实的割裂

文档上白纸黑字写着某个字段是Integer类型，单位是克。作为严谨的开发者，你按照文档写了代码：

java复制int weight = jsonObject.getIntValue("weight");

直到某天凌晨3点，你被报警电话吵醒，发现系统抛出了NumberFormatException。查看日志才发现，对方传的是"12.5kg"这样的字符串。

2.2 构建健壮的数据解析器

面对这种现实，我们不得不构建一个"防弹"解析器：

java复制public static Integer parseWeight(Object weightObj) {
    if (weightObj == null) {
        return null;
    }
    
    if (weightObj instanceof Number) {
        return ((Number)weightObj).intValue();
    }
    
    String weightStr = weightObj.toString().trim();
    if (weightStr.isEmpty() || "null".equalsIgnoreCase(weightStr)) {
        return