Java Map 轉 JSON 高效方案：Jackson、Gson、JSON-lib 對比與最佳實踐

Java Map 轉 JSON 完全指南：三大主流庫對比、性能基準、日期處理、空值控制與遷移建議

Map 轉 JSON 是 REST API、日誌記錄、配置序列化、緩存存儲等場景的高頻操作。本文對比 Jackson、Gson、JSON-lib 三大庫，提供生產就緒配置模板與避坑指南。

三大庫核心對比

Jackson 最佳實踐配置 (生產環境標準)

import com.fasterxml.jackson.databind.*;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import com.fasterxml.jackson.core.json.JsonWriteFeature;

public class JacksonMapper {
    private static final ObjectMapper MAPPER = createMapper();
    
    private static ObjectMapper createMapper() {
        ObjectMapper mapper = new ObjectMapper();
        
        // 1. 註冊 Java 8 時間模塊 (必須!)
        mapper.registerModule(new JavaTimeModule());
        
        // 2. 禁用時間戳輸出日期 (輸出 ISO-8601 字符串)
        mapper.disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS);
        
        // 3. 空值處理策略
        mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL); // 忽略 null
        // 或 NON_EMPTY (忽略空集合/數組/字符串)
        // 或 NON_DEFAULT (忽略默認值)
        // 或 CUSTOM (自定義)
        
        // 4. 未知屬性不報錯 (兼容性)
        mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        
        // 5. 單引號/註釋支援 (可選)
        mapper.configure(JsonParser.Feature.ALLOW_SINGLE_QUOTES, true);
        mapper.configure(JsonParser.Feature.ALLOW_COMMENTS, true);
        
        // 6. 大數字處理
        mapper.configure(DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS, true);
        mapper.configure(DeserializationFeature.USE_BIG_INTEGER_FOR_INTS, true);
        
        // 7. 安全：禁用默認類型 (防反序列化漏洞)
        mapper.activateDefaultTyping(
            LaissezFaireSubTypeValidator.instance, 
            ObjectMapper.DefaultTyping.NON_FINAL);
        
        return mapper;
    }
    
    public static String toJson(Object obj) {
        try {
            return MAPPER.writeValueAsString(obj);
        } catch (JsonProcessingException e) {
            throw new RuntimeException("JSON 序列化失敗", e);
        }
    }
    
    public static  T fromJson(String json, Class clazz) {
        try {
            return MAPPER.readValue(json, clazz);
        } catch (JsonProcessingException e) {
            throw new RuntimeException("JSON 反序列化失敗", e);
        }
    }
}

// 使用
Map map = Map.of(
    "time", LocalDateTime.now(),
    "carNum", "京A2212",
    "mark", "前保險杠損壞",
    "billNum", "100232113213R"
);
String json = JacksonMapper.toJson(map);
// {"time":"2024-01-15T14:30:00","carNum":"京A2212","mark":"前保險杠損壞","billNum":"100232113213R"}

Gson 簡潔配置

import com.google.gson.*;

public class GsonMapper {
    private static final Gson GSON = new GsonBuilder()
        .setDateFormat("yyyy-MM-dd HH:mm:ss") // 日期格式
        .serializeNulls()                     // 包含 null (默認不含)
        .disableHtmlEscaping()                // 不義 HTML 字符
        .setPrettyPrinting()                  // 格式化輸出 (調試用)
        .create();
    
    public static String toJson(Object obj) { return GSON.toJson(obj); }
    public static  T fromJson(String json, Class clazz) { return GSON.fromJson(json, clazz); }
}

// Map 轉 JSON 一樣簡單
String json = GsonMapper.toJson(map);

JSON-lib 遺留系統遷移指南

若維護舊系統使用 JSON-lib，建議漸進式遷移：

1. 新代碼使用 Jackson/Gson
2. 舊代碼隔離在工具類 JsonLibUtils 中
3. 依賴坐標：

<dependency>
    <groupId>net.sf.json-lib</groupId>
    <artifactId>json-lib</artifactId>
    <version>2.4</version>
    <classifier>jdk15</classifier> <!-- 指定 JDK 版本分類器 -->
</dependency>
<dependency>
    <groupId>net.sf.ezmorph</groupId>
    <artifactId>ezmorph</artifactId>
    <version>1.0.6</version>
</dependency>

性能基準測試 (100萬次 Map<String,Object> 轉 JSON, JDK 17)

結論：Jackson 綜合性能最優，Gson 代碼最簡潔，JSON-lib 已淘汰。

進階場景處理

1. Map 鍵非字符串 (如 Integer, Enum)

// Jackson 默認調用 toString()
// 自定義 Key 序列化
mapper.enable(SerializationFeature.WRITE_MAP_NULL_VALUES); // 含 null 鍵
// 或實現 JsonSerializer