Spring Session JDBC JSON存储格式问题解析与解决方案

问题背景

在使用Spring Session JDBC模块时，开发者尝试将自定义对象以JSON格式存储到数据库中，但遇到了两个主要问题：

1. 类型转换异常：从Session中获取对象时出现LinkedHashMap cannot be cast to MyObject错误
2. 数据库类型不匹配：PostgreSQL报错"column is of type jsonb but expression is of type bytea"

问题根源分析

类型转换异常

当Spring Session尝试将存储在数据库中的JSON数据反序列化为Java对象时，如果没有明确的类型信息，Jackson默认会将JSON对象反序列化为LinkedHashMap。这是因为：

1. 默认配置下，Jackson不知道目标类型是什么
2. 需要显式配置类型信息才能正确反序列化

数据库类型不匹配

虽然示例中已经配置了CREATE语句将字节数组转换为jsonb类型，但UPDATE语句没有进行相应配置，导致PostgreSQL无法正确处理数据类型转换。

完整解决方案

1. 配置SQL语句

需要同时自定义CREATE和UPDATE语句，确保所有写入操作都正确处理JSON类型：

private static final String CREATE_SESSION_ATTRIBUTE_QUERY = """
    INSERT INTO %TABLE_NAME%_ATTRIBUTES (SESSION_PRIMARY_ID, ATTRIBUTE_NAME, ATTRIBUTE_BYTES)
    VALUES (?, ?, encode(?, 'escape')::jsonb)
    """;

private static final String UPDATE_SESSION_ATTRIBUTE_QUERY = """
    UPDATE %TABLE_NAME%_ATTRIBUTES
    SET ATTRIBUTE_BYTES = encode(?, 'escape')::jsonb
    WHERE SESSION_PRIMARY_ID = ?
    AND ATTRIBUTE_NAME = ?
    """;

@Bean
SessionRepositoryCustomizer<JdbcIndexedSessionRepository> customizer() {
    return (sessionRepository) -> {
        sessionRepository.setCreateSessionAttributeQuery(CREATE_SESSION_ATTRIBUTE_QUERY);
        sessionRepository.setUpdateSessionAttributeQuery(UPDATE_SESSION_ATTRIBUTE_QUERY);
    };
}

2. 配置ObjectMapper

为了正确处理对象序列化和反序列化，需要自定义ObjectMapper：

@Bean("springSessionConversionService")
public GenericConversionService springSessionConversionService(ObjectMapper objectMapper) {
    ObjectMapper copy = objectMapper.copy();
    // 允许忽略未知属性
    copy.disable(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES);
    // 启用默认类型信息
    copy.activateDefaultTyping(
        copy.getPolymorphicTypeValidator(),
        ObjectMapper.DefaultTyping.NON_FINAL,
        JsonTypeInfo.As.PROPERTY
    );
    
    GenericConversionService converter = new GenericConversionService();
    converter.addConverter(Object.class, byte[].class, new SerializingConverter(new JsonSerializer(copy)));
    converter.addConverter(byte[].class, Object.class, new DeserializingConverter(new JsonDeserializer(copy)));
    return converter;
}

替代方案

除了使用activateDefaultTyping外，还可以通过以下方式解决类型问题：

1. 使用@JsonTypeInfo注解：在自定义类上添加类型信息注解
2. 创建Mixin类：为需要特殊处理的类创建Jackson Mixin
3. 注册特定模块：如Spring Security提供的SecurityJackson2Modules

最佳实践建议

1. 对于生产环境，建议使用明确的类型注解而非默认类型激活
2. 考虑为Session中存储的对象实现Serializable接口
3. 保持Session中存储的对象结构简单，避免复杂对象图
4. 对于大型对象，考虑使用外部存储，Session中只保存引用

总结

通过正确配置SQL语句和ObjectMapper，可以解决Spring Session JDBC中使用JSON格式存储自定义对象时遇到的类型转换和数据库类型问题。关键在于确保：

1. 数据库操作正确处理JSON类型
2. Jackson能够正确识别和转换对象类型

这种配置方式既保持了数据的可读性（JSON格式），又能正确处理Java对象与数据库之间的转换。