Spring Data MongoDB枚举字段自定义转换器未生效问题求助

看起来你遇到的问题是自定义的StringToMetricTypeConverter已经注册，但读取MongoDB数据时并没有被调用，结合你使用的Spring Boot 1.5.9版本，我来帮你排查几个关键问题并给出解决方案：

1. 首先检查Metric类的字段访问权限 #

你的Metric类中type和value字段是包私有（默认权限），Spring Data MongoDB在映射字段时可能无法正确访问这些字段，导致转换器没有机会被触发。建议你给字段添加getter/setter方法，或者将字段改为public，同时保留无参构造函数（这是MongoDB映射的要求）：

public class Metric {
    private MetricType type;
    private int value;

    // 必须保留无参构造函数，供MongoDB映射使用
    public Metric() {}

    // Getter和Setter方法
    public MetricType getType() {
        return type;
    }

    public void setType(MetricType type) {
        this.type = type;
    }

    public int getValue() {
        return value;
    }

    public void setValue(int value) {
        this.value = value;
    }
}

2. 调整Mongo配置类的实现方式 #

在Spring Boot 1.5.x版本中，手动创建MongoTemplate的方式可能会和自动配置的实例冲突，导致自定义转换器没有被正确应用。更稳妥的方式是继承AbstractMongoConfiguration来配置MongoDB，这样能确保自定义转换器被加载到正确的映射上下文里：

@Configuration
public class MongoConfig extends AbstractMongoConfiguration {

    @Value("${spring.data.mongodb.host:localhost}")
    private String mongoHost;

    @Value("${spring.data.mongodb.port:27017}")
    private int mongoPort;

    @Value("${spring.data.mongodb.database:your-db-name}")
    private String databaseName;

    @Override
    protected String getDatabaseName() {
        return databaseName;
    }

    @Override
    public Mongo mongo() throws Exception {
        return new MongoClient(mongoHost, mongoPort);
    }

    // 注册自定义转换器
    @Override
    public CustomConversions customConversions() {
        List<Converter<?, ?>> converters = new ArrayList<>();
        converters.add(new StringToMetricTypeConverter());
        return new CustomConversions(converters);
    }
}

3. 验证数据库中字段的存储类型 #

你的转换器是String转MetricType，但如果MongoDB中type字段存储的不是字符串类型（比如是枚举的ordinal整数），这个转换器就不会被触发。如果是这种情况，你需要创建对应的IntegerToMetricTypeConverter：

@ReadingConverter
public class IntegerToMetricTypeConverter implements Converter<Integer, MetricType> {
    @Override
    public MetricType convert(Integer dbData) {
        try {
            return MetricType.values()[dbData];
        } catch (ArrayIndexOutOfBoundsException e) {
            return MetricType.UNKNOWN;
        }
    }
}

记得把这个转换器也添加到customConversions()的列表中。

4. 验证转换器是否被正确触发 #

可以在StringToMetricTypeConverter的convert方法中添加日志打印，比如：

@ReadingConverter
public class StringToMetricTypeConverter implements Converter<String, MetricType> {
    private static final Logger logger = LoggerFactory.getLogger(StringToMetricTypeConverter.class);

    @Override
    public MetricType convert(String dbData) {
        logger.info("正在转换数据库值: {}", dbData);
        try {
            return MetricType.valueOf(dbData);
        } catch (IllegalArgumentException e) {
            logger.warn("无法识别的MetricType: {}, 转为UNKNOWN", dbData);
            return MetricType.UNKNOWN;
        }
    }
}

这样就能直观看到转换器是否被调用，以及转换的具体数据。

按照以上步骤调整后，你的自定义转换器应该就能正常工作了。

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