Java JPA：允许空值的Repository方法为何抛出IllegalArgumentException？

我有一个JPA Repository方法，传入空值时会抛出IllegalArgumentException，但数据库表中对应字段允许为空。我判断异常在到达持久化逻辑之前就触发了，以下是关键异常信息、调用代码、转换器及Repository定义，恳请提供排查思路。

关键异常信息 #

java.lang.IllegalArgumentException: Parameter a_e_mark in CMarkRepository.insertCMark must not be null!
    at org.springframework.data.repository.core.support.MethodInvocationValidator.invoke(MethodInvocationValidator.java:93)
    at org.springframework.aop.framework.ReflectiveMethodInvocation.proceed(ReflectiveMethodInvocation.java:186)
    at org.springframework.aop.framework.JdkDynamicAopProxy.invoke(JdkDynamicAopProxy.java:215)
    at com.sun.proxy.$Proxy142.insertCMark(Unknown Source)
    at service.SMarkService.postCMark(SMarkService.java:213)
    at controller.SMarkController.postCMark(SMarkController.java:259)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
    at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62)
    at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
    .....

调用代码关键部分 #

public int postCMark(CMark cMark) {

    CMark cm = null;
    int status = 0;
    try {
        status = cMarkRepository.insertCMark(cMark.getCFk(), stringListToStringArray(cMark.getAEMark()));
    } catch ( Exception e) {
        e.printStackTrace();
    }
    return status;
}
private String stringListToStringArray(List<String> stringList) {
    StringListConverterCommaDelim stringListConverterCommaDelim = new StringListConverterCommaDelim();
    return stringListConverterCommaDelim.convertToDatabaseColumn(stringList);
}

转换器代码 #

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import java.util.Arrays;
import java.util.List;
import static java.util.Collections.emptyList;

@Converter
public class StringListConverterCommaDelim implements AttributeConverter<List<String>, String> 
{
    private static final String SPLIT_CHAR = ",";

    @Override
    public String convertToDatabaseColumn(List<String> stringList) {
        String splitString = null;
        if(stringList != null) {
            splitString = String.join(SPLIT_CHAR, stringList);
            splitString = "{" + splitString + "}";
        }
        return splitString;
    }

    @Override
    public List<String> convertToEntityAttribute(String string) {
        return string != null ? Arrays.asList(string.split(SPLIT_CHAR)) : emptyList();
    }
}

Repository定义 #

public interface CMarkRepository extends JpaRepository <CMark, String> {

    @Transactional
    @Modifying
    @Query(value = "INSERT INTO c_mark(c_fk, a_e_mark) values(:c_fk, :a_e_mark\\:\\:character varying[])", nativeQuery = true)
    int insertClassMark(@Param("c_fk") String classification_fk, @Param("a_e_mark") String a_e_mark);
}

排查思路 #

• 检查Spring Data参数校验配置：异常来自MethodInvocationValidator，这是Spring Data用于校验Repository方法参数的组件。若项目启用了参数非空校验（比如通过@EnableJpaRepositories的相关配置），会默认拦截null参数，可查看配置类确认是否有强制非空的设置。
• 显式标记参数允许为空：在Repository方法的a_e_mark参数上添加@Nullable注解（Spring的org.springframework.lang.Nullable），告知Spring Data该参数允许为空，跳过非空校验。
• 核对方法名一致性：异常信息中提到的方法是insertCMark，但Repository定义的方法名是insertClassMark，存在名称不匹配问题，需检查是否是拼写错误或代理类生成异常，确保调用方法与Repository定义一致。
• 处理转换器空值返回：当cMark.getAEMark()为null时，转换器返回null，此时需确保Repository方法参数允许接收null值，否则会触发校验失败。
• 确认Spring Data版本特性：不同版本的Spring Data对参数校验的默认行为可能不同，可查看对应版本文档，确认是否默认开启参数非空校验，若不需要可通过配置关闭。

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