JPA原生查询中如何将option_list映射为List<Map<String,Object>>

问题原因 #

你遇到的问题是因为JPA默认无法自动将数据库返回的JSON字符串（如[{"image": "image1", "option": "L"}]）直接转换为List<Map<String, Object>>类型。JDBC层面会将JSON类型字段以字符串形式返回，而投影接口没有内置的转换逻辑处理这种复杂类型。

解决方案 #

方案1：使用自定义属性转换器（AttributeConverter）

创建一个转换器，自动将JSON字符串与List<Map<String, Object>>互相转换，JPA会在映射时自动调用这个转换器。

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import jakarta.persistence.AttributeConverter;
import jakarta.persistence.Converter;
import java.io.IOException;
import java.util.List;
import java.util.Map;

@Converter(autoApply = true) // 自动应用到所有匹配的属性
public class JsonToListMapConverter implements AttributeConverter<List<Map<String, Object>>, String> {

    private final ObjectMapper objectMapper = new ObjectMapper();

    @Override
    public String convertToDatabaseColumn(List<Map<String, Object>> attribute) {
        try {
            return objectMapper.writeValueAsString(attribute);
        } catch (IOException e) {
            throw new IllegalArgumentException("无法将List转换为JSON字符串", e);
        }
    }

    @Override
    public List<Map<String, Object>> convertToEntityAttribute(String dbData) {
        try {
            return objectMapper.readValue(dbData, new TypeReference<List<Map<String, Object>>>() {});
        } catch (IOException e) {
            throw new IllegalArgumentException("无法将JSON字符串转换为List", e);
        }
    }
}

然后修改投影接口，保持原来的方法定义即可，JPA会通过转换器自动完成转换：

public interface VariationProjection {
    List<String> getTier_list();
    List<Map<String, Object>> getOption_list();
}

方案2：在投影中手动转换（无需修改实体）

如果不想全局应用转换器，可以先在投影中获取JSON字符串，再通过默认方法手动转换为目标类型：

import com.fasterxml.jackson.core.type.TypeReference;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.IOException;
import java.util.List;
import java.util.Map;

public interface VariationProjection {
    List<String> getTier_list();
    String getOption_list(); // 先获取原始JSON字符串

    // 默认方法实现转换逻辑
    default List<Map<String, Object>> getOptionListAsMap() {
        ObjectMapper objectMapper = new ObjectMapper();
        try {
            return objectMapper.readValue(getOption_list(), new TypeReference<List<Map<String, Object>>>() {});
        } catch (IOException e) {
            throw new RuntimeException("解析option_list失败", e);
        }
    }
}

使用时直接调用getOptionListAsMap()即可获取转换后的集合。

方案3：数据库层面处理（适用于支持JSON函数的数据库）

如果你的数据库是PostgreSQL，可以使用jsonb_array_elements函数将JSON数组拆分为多行，但这种方式会改变查询结果的结构，需要调整投影和后续处理逻辑，示例SQL如下：

SELECT 
    tier_id, tier_list, vm.id AS model_id, 
    jsonb_array_elements(tv.option_list) AS option_item,
    price, sku, stock
FROM (
    SELECT *
    FROM ecommerce.tier_variations tv
    WHERE tv.product_id = ?1 AND is_deleted = false
) AS tv
JOIN ecommerce.variation_models vm ON vm.tier_id = tv.id

此时投影接口需要改为接收单个Map<String, Object>类型的option_item，但会返回多条重复数据（每个数组元素对应一条），需要在业务层进行聚合。

注意事项 #

• 确保项目中已经引入Jackson依赖（Spring Boot项目默认已包含）。
• 如果使用方案1，确认数据库中option_list字段的类型是JSON（如MySQL的JSON、PostgreSQL的jsonb）。

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