错误：列的类型为 json，但表达式的类型为 Hibernate 中不同的字符

Question

我需要使用 spring 数据 jpa 在 postgres 中将实体类的两列映射为 json。在阅读了多个 stackoverflow 帖子和 baeldung 帖子后，

如何使用 JPA 将映射 JSON 列映射到 Java 对象

https://www.baeldung.com/hibernate-persist-json-object

我做了如下配置。但是，我面临错误“错误：列“标题”的类型为 json，但表达式的类型为不同的字符“

请提供一些解决此问题的指针。

我有一个实体类如下

@Entity
@Data
@SuperBuilder
@NoArgsConstructor
@AllArgsConstructor
public class Task {
    @Id
    @GeneratedValue(strategy = IDENTITY)
    private Integer id;
    
    private String url;
    private String httpMethod;

    @Convert(converter = HashMapConverter.class)
    @Column(columnDefinition = "json")
    private Map<String, String> headers;

    @Convert(converter = HashMapConverter.class)
    @Column(columnDefinition = "json")
    private Map<String, String> urlVariables;
}

我创建了一个测试类来测试实体是否持久化。在运行这个 junit 时，下面的测试用例失败，错误如下

@SpringBootTest
class TaskRepositoryTest {

    private static Task randomTask = randomTask();

    @Autowired
    private TaskRepository taskRepository;

    @BeforeEach
    void setUp() {
        taskRepository.deleteAll();
        taskRepository.save(randomTask);
    }

    public static Task randomTask() {
        return randomTaskBuilder().build();
    }

    public static TaskBuilder randomTaskBuilder() {
        Map<String,String> headers = new HashMap<>();
        headers.put(randomAlphanumericString(10),randomAlphanumericString(10));

        Map<String,String> urlVariables = new HashMap<>();
        urlVariables.put(randomAlphanumericString(10),randomAlphanumericString(10));

        return builder()
                .id(randomPositiveInteger())
                .httpMethod(randomAlphanumericString(10))
                .headers(headers)
                .urlVariables(urlVariables)
                .url(randomAlphanumericString(10)));
    }
}

使用 liquibase，我在 postgres DB 中创建了表，我可以看到列数据类型为 json。

databaseChangeLog:
  - changeSet:
      id: 1
      author: abc
      changes:
        - createTable:
            tableName: task
            columns:
              - column:
                  name: id
                  type: int
                  autoIncrement: true
                  constraints:
                    primaryKey: true
              - column:
                  name: url
                  type: varchar(250)
                  constraints:
                    nullable: false
                    unique: true
              - column:
                  name: http_method
                  type: varchar(50)
                  constraints:
                    nullable: false
              - column:
                  name: headers
                  type: json
              - column:
                  name: url_variables
                  type: json
      rollback:
        - dropTable:
            tableName: task

Answer 1

对于因为使用JdbcTemplate并收到此错误而登陆此处的任何人，解决方案非常简单：在 SQL 语句中，使用 或 CAST 转换 JSON 参数::jsonb。

例如String INSERT_SQL = "INSERT INTO xxx (id, json_column) VALUES(?, ?)";

变成String INSERT_SQL = "INSERT INTO xxx (id, json_column) VALUES(?, ?::jsonb)";

或使用命名参数String INSERT_SQL = "INSERT INTO xxx (id, json_column) VALUES(:id, CAST(:json_column AS JSONB))";

Answer 2

替代解决方案使用org.hibernate.annotations.ColumnTransformer

样本实体

import org.hibernate.annotations.ColumnTransformer;

@Entity
@Table
public class SomeEntity {

  @Id
  @GeneratedValue(strategy = GenerationType.SEQUENCE)
  private Long id;

  @Column(name = "some_class", columnDefinition = "jsonb")
  @Convert(converter = SomeClassConvertor.class)
  @ColumnTransformer(write = "?::jsonb")
  private SomeClass someClass;
}

样品转换器

import java.io.IOException;
import javax.persistence.AttributeConverter;
import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import com.airtel.africa.entity.SomeClass;
import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.ObjectMapper;
import lombok.extern.slf4j.Slf4j;

@Slf4j
public class SomeClassConvertor implements AttributeConverter<SomeClass, String> {
  @Autowired
  ObjectMapper objectMapper;

  @Override
  public String convertToDatabaseColumn(SomeClass someClass) {
    String someClassJson = null;
    try {
      someClassJson = objectMapper.writeValueAsString(someClass);
    } catch (final JsonProcessingException e) {
      log.error("JSON writing error", e);
    }

    return someClassJson;
  }

  @Override
  public SomeClass convertToEntityAttribute(String someClassJSON) {
    SomeClass someClass = null;
    if (StringUtils.isBlank(someClassJSON)) {
      return someClass;
    }
    try {
      someClass = objectMapper.readValue(someClassJSON, someClass.class);
    } catch (final IOException e) {
      log.error("JSON reading error", e);
    }
    return someClass;
  }
}

Answer 3

上面的配置没有起作用。

因此，我按照下面的链接来解决用例

https://vladmihalcea.com/how-to-map-json-objects-using-generic-hibernate-types/

Spring Boot 升级后“未找到提供程序 com.fasterxml.jackson.module.jaxb.JaxbAnnotationModule”

在 pom.xml 中添加了额外的依赖项

        <dependency>
            <groupId>com.fasterxml.jackson.module</groupId>
            <artifactId>jackson-module-jaxb-annotations</artifactId>
        </dependency>
        <dependency>
            <groupId>com.vladmihalcea</groupId>
            <artifactId>hibernate-types-52</artifactId>
            <version>2.9.11</version>
        </dependency>

删除了 HashMapConverter 配置并在实体类中进行了以下更改

@Entity
@Data
@SuperBuilder
@NoArgsConstructor
@AllArgsConstructor
@ToString(callSuper = true)
@TypeDefs({
        @TypeDef(name = "json", typeClass = JsonStringType.class),
        @TypeDef(name = "jsonb", typeClass = JsonBinaryType.class)
})
public class Task {
    @Id
    @GeneratedValue(strategy = IDENTITY)
    private Integer id;
    
    private String url;
    private String httpMethod;

    @Type(type = "jsonb")
    @Column(columnDefinition = "json")
    private Map<String, String> headers;

    @Type(type = "jsonb")
    @Column(columnDefinition = "json")
    private Map<String, String> urlVariables;
}

经过这些更改后，TaskRepositoryTest 通过了。

Answer 4

当我将项目从 MySQL 8.0.21 迁移到 Postgres 13 时，我遇到了这个问题。我的项目使用 Spring boot 和 Hibernate 类型依赖项版本 2.7.1。就我而言，解决方案很简单。

我所需要做的就是改变这一点并且它起作用了。

引用自Hibernate 类型文档页面。