ISBN字段需支持空值或有效格式，空值提交触发校验报错如何解决？

问题根源是默认的@ISBN注解会对所有非空值（甚至部分实现会校验null）强制做格式校验。要实现“空值放行、非空则校验”的逻辑，有以下几种可行方案：

1. 给@ISBN添加nullable = true参数（推荐） #

主流校验框架（如Hibernate Validator）的@ISBN注解支持nullable属性，设置为true后，null值会被跳过校验。如果要同时放行空字符串，大部分场景下该参数也能覆盖（部分框架会自动忽略空串）：

// 表单类修改后
@Getter
@Setter
public class SourceForm {
    @ISBN(type = ISBN.Type.ANY, nullable = true)    
    private String isbn;
}

实体类上的@ISBN建议同步修改，保持校验规则一致：

@Entity
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "sources")
public class SourceEntity extends BaseEntity{
    @ISBN(type = ISBN.Type.ANY, nullable = true)
    @Column(columnDefinition = "varchar(255) default ''", nullable = false)
    private String isbn;   
}

注意：实体类的@Column(nullable = false)是数据库层面约束，这里设置了默认空串，和校验逻辑不冲突——空值提交时，数据库会自动填充默认空串，而校验层已经放行空值。

2. 结合@Nullable注解兜底 #

如果你的@ISBN注解不支持nullable参数，可以用@Nullable标记字段，明确告诉校验框架空值无需校验：

@Nullable
@ISBN(type = ISBN.Type.ANY)    
private String isbn;

3. 自定义校验逻辑（极端场景） #

如果上述方法都不生效，说明框架自带的@ISBN校验逻辑无法满足需求，此时可以自定义校验器：

// 自定义校验器
public class CustomIsbnValidator implements ConstraintValidator<ISBN, String> {
    private ISBN.Type type;

    @Override
    public void initialize(ISBN constraintAnnotation) {
        this.type = constraintAnnotation.type();
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        // 空值（包括null和空字符串）直接放行
        if (value == null || value.trim().isEmpty()) {
            return true;
        }
        // 非空时校验ISBN格式
        return org.hibernate.validator.internal.constraintvalidators.hv.ISBNValidator.isValidISBN(value, type);
    }
}

之后在@ISBN注解上指定这个自定义校验器（如果是自定义注解的话），或者替换原有注解的校验器实现即可。

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