Java 實體類轉 JSON 兩大主流方案：Jackson 與 Fastjson 實戰對比

依賴準備

現代項目建議使用 Maven/Gradle 管理依賴，避免手動導入 JAR 包：

Jackson（Spring 生態標準）

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

Fastjson（阿里巴巴高性能庫）

<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>2.0.41</version>
</dependency>

實體類定義

public class Emp {
    private Integer id;
    private String name;
    private Integer dptNo;
    private String gender;
    private String duty;
    // 省略 Getter/Setter，建議使用 Lombok @Data
}

方案一：Jackson ObjectMapper（推薦，功能豐富）

import com.fasterxml.jackson.databind.ObjectMapper;

public class JacksonDemo {
    private static final ObjectMapper MAPPER = new ObjectMapper(); // 線程安全，可復用
    
    public static <T> String toJson(T obj) {
        try {
            return MAPPER.writeValueAsString(obj);
        } catch (Exception e) {
            throw new RuntimeException("JSON 序列化失敗", e);
        }
    }
    
    public static void main(String[] args) {
        Emp emp = new Emp();
        emp.setId(1);
        emp.setName("張三");
        emp.setGender("男");
        emp.setDptNo(1);
        emp.setDuty("職員");
        
        String json = toJson(emp);
        System.out.println(json);
        // 輸出: {"id":1,"name":"張三","dptNo":1,"gender":"男","duty":"職員"}
    }
}

進階配置

// 忽略 NULL 字段
mapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
// 日期格式化
mapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
// 驼峰轉下劃線
mapper.setPropertyNamingStrategy(PropertyNamingStrategy.SNAKE_CASE);

方案二：Fastjson（語法簡潔，性能極致）

import com.alibaba.fastjson.JSON;

public class FastjsonDemo {
    public static void main(String[] args) {
        Emp emp = new Emp();
        emp.setId(1);
        emp.setName("李四");
        emp.setGender("女");
        emp.setDptNo(2);
        emp.setDuty("經理");
        
        String json = JSON.toJSONString(emp);
        System.out.println(json);
        // 輸出: {"dptNo":2,"duty":"經理","gender":"女","id":1,"name":"李四"}
    }
}

常用註解

@JSONField(name = "dept_no")  // 指定 JSON 字段名
private Integer dptNo;

@JSONField(format = "yyyy-MM-dd")  // 日期格式化
private Date createTime;

@JSONField(serialize = false)  // 忽略序列化
private String password;

深度對比與選型指南

最佳實踐建議

1. Spring Boot 項目：直接使用自動配置的 ObjectMapper Bean，零配置即用
2. 高性能場景/存量 Fastjson 項目：升級至 2.x 版本，開啟 ParserConfig.getGlobalInstance().setAutoTypeSupport(false)
3. 雙庫共存：統一封裝 JsonUtils 工具類，業務代碼無感切換
4. 避免原文錯誤：原文代碼混用 net.sf.json（舊版 json-lib）與 Jackson，且重複序列化，切勿參考

總結

Jackson 與 Fastjson 均為成熟可靠的 JSON 庫。現代 Spring 生態首選 Jackson，追求極致性能或存量項目可用 Fastjson 2.x。核心原則：統一工具類封裝、合理配置序列化策略、拒絕混用多庫。