旧版本属性为null时，Javers的CustomValueComparator未被调用

我之前也踩过Javers这个坑！你遇到的情况很可能是Javers默认的null处理逻辑绕过了你的自定义比较器，或者你的比较器注册/实现细节有问题。下面一步步帮你解决：

问题根源 #

Javers默认对null值的判断逻辑是：只要两个值中有一个是null，另一个非null，就直接判定为变化，不会调用全局的CustomValueComparator——这是很多人容易忽略的点！所以当旧对象属性为null，新对象为空字符串时，Javers默认认为这是一个值变更，而没有走到你的自定义比较器里。

解决方案：正确实现并注册自定义比较器 #

1. 实现支持null处理的ValueComparator #

确保你的比较器明确处理null和空字符串的相等逻辑，不要依赖Javers的默认判断：

import org.javers.core.diff.custom.ValueComparator;

public class StringNullEmptyComparator implements ValueComparator<String> {
    @Override
    public boolean equals(String a, String b) {
        // 统一把null转为空字符串再比较
        String normalizedA = (a == null) ? "" : a;
        String normalizedB = (b == null) ? "" : b;
        return normalizedA.equals(normalizedB);
    }

    @Override
    public String toString(String value) {
        // 统一输出格式，避免Javers记录时区分null和空串
        return (value == null) ? "" : value;
    }

    @Override
    public String getSignature() {
        // 唯一标识这个比较器，Javers用来缓存比较逻辑
        return "StringNullEmptyComparator";
    }
}

2. 正确注册比较器（两种方式） #

方式一：全局注册（所有String类型属性生效）

Javers javers = JaversBuilder.javers()
    .registerValueComparator(String.class, new StringNullEmptyComparator())
    // 关键：如果是Javers 6.x及以上版本，需要开启这个配置让自定义比较器处理null
    .withValueEqualsStrategy(ValueEqualsStrategy.CUSTOM)
    .build();

注意：Javers 6.x之后引入了ValueEqualsStrategy，默认是DEFAULT，只会在非null值间调用自定义比较器，所以必须显式设置为CUSTOM才能让比较器处理null场景。

方式二：属性级注册（仅特定类的特定属性生效）

如果不想全局修改String的比较逻辑，可以针对单个属性注册：

Javers javers = JaversBuilder.javers()
    .registerPropertyComparator(YourEntity.class, "yourStringProperty", new StringNullEmptyComparator())
    .build();

3. 测试验证 #

用你的JUnit测试代码验证，比如：

@Test
void testNullVsEmptyString() {
    YourEntity oldEntity = new YourEntity(null);
    YourEntity newEntity = new YourEntity("");
    
    Javers javers = JaversBuilder.javers()
        .registerValueComparator(String.class, new StringNullEmptyComparator())
        .withValueEqualsStrategy(ValueEqualsStrategy.CUSTOM)
        .build();
    
    Diff diff = javers.compare(oldEntity, newEntity);
    // 期望没有变更记录
    assertThat(diff.getChanges()).isEmpty();
}

替代方案：提前归一化（不推荐但可行） #

你提到的提前把null转为空字符串的方式虽然可行，但会污染原始对象的数据，不如自定义比较器优雅，除非你的业务场景必须修改原始数据。

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