如何正确实现JPA AttributeConverter妥善处理NULL值

核心问题出在convertToDatabaseColumn方法中使用的Objects.toString(path)调用：
java.util.Objects.toString(Object o)的默认实现逻辑为：入参非空时返回入参的toString()结果，入参为null时返回字符串字面量"null"，而非Java层面的null值。
这就导致当Java端传入的Path属性为null时，转换器最终返回的是内容为"null"的非空字符串，Hibernate识别到返回值非空，就会把"null"作为普通字符串写入数据库列，而非生成SQL层面的NULL值。

修改convertToDatabaseColumn的空值处理逻辑，入参为null时直接返回Java null即可，反向转换（数据库字段转实体属性）的原有逻辑没有问题，无需调整。
修复后的完整代码：

@Converter
public class PathConverter 
  implements AttributeConverter<Path, String> {
  @Override
  public String convertToDatabaseColumn(Path path) {
    // 空值直接返回null，非空时再转字符串
    return path == null ? null : path.toString();
  }

  @Override
  public Path convertToEntityAttribute(String columnValue) {
    return Optional.ofNullable(columnValue)
                   .map(Paths::get).orElse(null);
  }
}

如果希望继续使用Objects工具类，也可以调用其支持自定义空默认值的重载方法，效果完全一致：

@Override
public String convertToDatabaseColumn(Path path) {
  return Objects.toString(path, null);
}

• 实体中Path属性为null时，转换器返回Java null，Hibernate会正确映射为SQL NULL写入数据库
• 若对应数据库列配置了NOT NULL约束，写入空值时会正常触发约束违反报错，符合预期
• 非空值的双向转换逻辑不受影响，保持原有正常运行的状态

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