完美解決：應用版本更新，增加字段導致 Redis 舊數據反序列化報錯

前言

在敏捷開發和快速迭代的今天，我們經常需要為現有的業務模型增加新的字段。但一個看似簡單的操作，卻可能給正在穩定運行的系統埋下“地雷”。

一個典型的場景是：我們的 Java 應用使用 Spring Data Redis 緩存對象，序列化方式為 JSON。當 V2 版本發布時，我們給 User 對象增加了一個 email 字段。部署新版本后，系統開始頻繁報錯，日志顯示在從 Redis 讀取舊的 User 數據時發生了反序列化異常。

這篇文章將深入剖析這個問題背后的原因，并提供在實際項目中行之有效的解決方案，無論你使用的是 Jackson 還是 Fastjson。

問題復現

假設我們的系統 V1 版本有這樣一個用戶類：

// V1 版本
public class User {private String name;private int age;// ... getters and setters
}

線上 Redis 緩存中存儲了大量序列化后的 User 對象，其 JSON 格式如下：

{"name": "Alice","age": 30
}

在 V2 版本中，我們為 User 類增加了一個 address 字段：

// V2 版本
public class User {private String name;private int age;private String address; // 新增字段// ... getters and setters
}

問題來了：當 V2 版本的應用啟動后，嘗試從 Redis 讀取 V1 版本存入的舊數據時，一切正常。但是，如果 V2 版本存入了一條新數據，而 V1 版本的（未下線的）服務嘗試讀取這條新數據時，就會立刻觸發致命錯誤！

V2 版本存入的數據：

{"name": "Bob","age": 25,"address": "123 Main St" // 新增字段
}

V1 版本的服務在讀取它時，會拋出類似這樣的異常：
com.fasterxml.jackson.databind.exc.UnrecognizedPropertyException: Unrecognized field "address" ...

這個錯誤會中斷業務邏輯，如果發生在核心流程上，甚至可能導致服務不可用。

為什么會報錯？深入 Jackson 的默認機制

在 Spring Boot 生態中，spring-boot-starter-data-redis 默認推薦使用 GenericJackson2JsonRedisSerializer 作為值的序列化器。它底層依賴于強大的 Jackson 庫。

問題的根源在于 Jackson 的一項默認安全特性：

DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES

這個特性的默認值是 true。它意味著，當 Jackson 在反序列化一個 JSON 字符串時，如果在 JSON 中發現了目標 Java 類里不存在的屬性，它會認為這是一種潛在的錯誤或數據污染，并選擇立即拋出異常來提醒開發者。

這是一個“嚴格模式”的設計，旨在確保數據的精確匹配，防止意外的數據注入。但在版本迭代、字段只增不減的場景下，這個特性就成了我們需要解決的“麻煩”。

解決方案：配置你的 `RedisTemplate`

要解決這個問題，我們不能改變 Redis 中已存在的數據，只能讓我們的應用程序變得更加“寬容”和“健壯”，能夠向后兼容。

核心思路是：創建一個自定義配置的 ObjectMapper，關閉 FAIL_ON_UNKNOWN_PROPERTIES 特性，并將其應用到 RedisTemplate 中。

Spring Boot 配置實例

在你的配置類（如 RedisConfig.java）中，添加如下 Bean：

import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.lettuce.LettuceConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.StringRedisSerializer;@Configuration
public class RedisConfig {@Beanpublic RedisTemplate<String, Object> redisTemplate(LettuceConnectionFactory connectionFactory) {RedisTemplate<String, Object> template = new RedisTemplate<>();template.setConnectionFactory(connectionFactory);// --- 核心配置：創建自定義的 Jackson 序列化器 ---// 1. 創建 ObjectMapperObjectMapper objectMapper = new ObjectMapper();// 2. 配置 ObjectMapper：忽略在 JSON 中存在但 Java 對象中沒有的屬性objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);// 3. 注冊 Java 8 日期時間模塊，處理 LocalDateTime, LocalDate 等類型objectMapper.registerModule(new JavaTimeModule());// 4. 創建 GenericJackson2JsonRedisSerializerGenericJackson2JsonRedisSerializer jacksonSerializer = new GenericJackson2JsonRedisSerializer(objectMapper);// --- 設置 RedisTemplate 的序列化器 ---// Key 使用 String 序列化器template.setKeySerializer(new StringRedisSerializer());template.setHashKeySerializer(new StringRedisSerializer());// Value 使用我們自定義的 Jackson 序列化器template.setValueSerializer(jacksonSerializer);template.setHashValueSerializer(jacksonSerializer);template.afterPropertiesSet();return template;}
}

配置完成后，重啟你的應用。現在，即使應用讀取到包含未知字段的 JSON 數據，也不會再拋出異常，而是會優雅地忽略掉這些新字段，只解析它認識的字段。

如果我用的是 Fastjson 呢？

對于使用 Fastjson 的開發者來說，情況恰好相反。Fastjson 默認行為就非常“寬容”。

當 JSON 字段比 Java 對象多時：Fastjson 默認會忽略未知字段，不會報錯。這正是我們期望的行為。
當 Java 對象字段比 JSON 多時：和 Jackson 一樣，Fastjson 也不會報錯，缺失的字段會被賦予 null 或 Java 默認值。

下表總結了二者的核心區別：

不匹配情況	Fastjson 默認行為	Jackson 默認行為
JSON 字段 > Java 字段<br>(JSON 中有未知字段)	忽略未知字段，不報錯	拋出異常，報錯
Java 字段 > JSON 字段<br>(JSON 中缺少字段)	缺失字段賦予默認值，不報錯	缺失字段賦予默認值，不報錯

如果你因為某些原因，希望 Fastjson 像 Jackson 一樣實行嚴格模式，可以在解析時傳入 Feature.FailOnUnmatchedProperties。

?? 安全提醒：雖然 Fastjson 在此場景下行為友好，但其歷史上因 autoType 功能（@type）存在多個嚴重的安全漏洞。請務必使用最新版本，并絕對不要開啟 autoType，除非你完全了解其風險。

簡單的驗證過程

<dependencies><dependency><groupId>org.springframework.data</groupId><artifactId>spring-data-redis</artifactId><version>2.7.15</version> </dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-databind</artifactId><version>2.15.2</version> </dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-core</artifactId><version>2.15.2</version></dependency><dependency><groupId>com.fasterxml.jackson.core</groupId><artifactId>jackson-annotations</artifactId><version>2.15.2</version></dependency></dependencies>

import org.springframework.data.redis.serializer.GenericJackson2JsonRedisSerializer;
import org.springframework.data.redis.serializer.SerializationException;import java.io.Serializable;
import java.util.Arrays;public class JacksonSerializerTest {// V1 版本的學生類static class StudentV1 implements Serializable {private String name;private int age;// 必須有無參構造函數public StudentV1() {}public StudentV1(String name, int age) {this.name = name;this.age = age;}// getters and setters...public String getName() { return name; }public void setName(String name) { this.name = name; }public int getAge() { return age; }public void setAge(int age) { this.age = age; }@Overridepublic String toString() {return "StudentV1{" + "name='" + name + '\'' + ", age=" + age + '}';}}// V2 版本的學生類（增加了 address 字段）static class StudentV2 implements Serializable {private String name;private int age;private String address; // 新增字段public StudentV2() {}// getters and setters...public String getName() { return name; }public void setName(String name) { this.name = name; }public int getAge() { return age; }public void setAge(int age) { this.age = age; }public String getAddress() { return address; }public void setAddress(String address) { this.address = address; }@Overridepublic String toString() {return "StudentV2{" + "name='" + name + '\'' + ", age=" + age + ", address='" + address + '\'' + '}';}}public static void main(String[] args) {// 創建默認的序列化器（FAIL_ON_UNKNOWN_PROPERTIES = true）GenericJackson2JsonRedisSerializer serializer = new GenericJackson2JsonRedisSerializer();// 1. 模擬場景：新版代碼（V2）序列化，舊版代碼（V1）反序列化System.out.println("--- 場景1：JSON字段比Java對象多 (默認會報錯) ---");StudentV2 newStudent = new StudentV2();newStudent.setName("Charlie");newStudent.setAge(22);newStudent.setAddress("456 Park Ave");// 序列化 V2 對象byte[] serializedData = serializer.serialize(newStudent);System.out.println("V2對象序列化后的JSON: " + new String(serializedData));// 嘗試用 V1 的類去反序列化try {StudentV1 oldStudent = (StudentV1) serializer.deserialize(serializedData, StudentV1.class);System.out.println("反序列化成功: " + oldStudent);} catch (SerializationException e) {System.err.println("反序列化失敗，符合預期！錯誤: " + e.getCause().getMessage());}System.out.println("\n--- 場景2：JSON字段比Java對象少 (默認不報錯) ---");StudentV1 oldStudent = new StudentV1("David", 35);// 序列化 V1 對象byte[] oldSerializedData = serializer.serialize(oldStudent);System.out.println("V1對象序列化后的JSON: " + new String(oldSerializedData));// 嘗試用 V2 的類去反序列化try {StudentV2 studentWithNewField = (StudentV2) serializer.deserialize(oldSerializedData, StudentV2.class);System.out.println("反序列化成功，符合預期！結果: " + studentWithNewField);System.out.println("新增的 address 字段值為: " + studentWithNewField.getAddress());} catch (SerializationException e) {System.err.println("反序列化失敗: " + e.getMessage());}}
}