C# 从MongoDB加载字符串存储的enum无法映射时如何设置兜底值

方案1：使用自定义读转换器（Spring Data MongoDB 场景） #

该方案仅针对CarType枚举类型生效，不会影响其他字符串字段的映射逻辑，是最常用的实现方式：

1. 首先给枚举补全兜底值

public enum CarType {
    SportCar,
    Suv,
    Hatchback,
    Unknown // 新增兜底 fallback 值
}

2. 编写自定义读转换器，处理枚举匹配失败的场景

import org.springframework.core.convert.converter.Converter;
import org.springframework.data.convert.ReadingConverter;

@ReadingConverter
public class CarTypeReadConverter implements Converter<String, CarType> {
    @Override
    public CarType convert(String source) {
        try {
            return CarType.valueOf(source);
        } catch (IllegalArgumentException e) {
            // 匹配失败返回兜底值
            return CarType.Unknown;
        }
    }
}

3. 注册转换器到MongoDB配置中

import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MongoCustomConversions;
import org.springframework.context.annotation.Bean;
import java.util.Collections;

@Configuration
public class MongoConfig {
    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        return new MongoCustomConversions(Collections.singletonList(new CarTypeReadConverter()));
    }
}

方案2：字段级自定义反序列化（通用场景，无需全局配置） #

如果你不想全局注册转换器，或者需要同一个枚举类型不同字段走不同的映射逻辑，可以直接在实体类的对应字段上绑定自定义反序列化器：
以Spring Data MongoDB默认使用的Jackson序列化框架为例：

1. 先写自定义反序列化器

import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import java.io.IOException;

public class CarTypeDeserializer extends StdDeserializer<CarType> {
    public CarTypeDeserializer() {
        super(CarType.class);
    }

    @Override
    public CarType deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        String value = p.getText();
        try {
            return CarType.valueOf(value);
        } catch (IllegalArgumentException e) {
            return CarType.Unknown;
        }
    }
}

2. 直接在实体类的CarType字段上标注注解即可，不需要修改全局配置

import org.springframework.data.mongodb.core.mapping.Document;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;

@Document(collection = "cars")
public class Car {
    private String id;
    private String name;
    // 仅该字段使用自定义反序列化逻辑
    @JsonDeserialize(using = CarTypeDeserializer.class)
    private CarType type;
    // 其他字符串字段不受影响
    private String brand;
}

如果使用MongoDB Java Driver原生客户端，也可以给指定字段配置自定义Codec实现相同逻辑，匹配失败时返回CarType.Unknown即可。你也可以配合定时任务，把数据库中所有匹配不到的旧枚举值批量更新为Unknown，避免后续一直走兜底逻辑。

内容的提问来源于stack exchange，提问作者Sugafree