MySQL仅非空参数生效WHERE条件及多值列表传参报错解决

当前SQL用IF分支拼接条件的写法存在两个核心问题：

• 多值列表参数传入时，持久层框架会把IN (:code)里的集合展开为逗号分隔的参数序列，外层包裹的IF判断会直接触发SQL语法错误，这就是多值传参失败的直接原因
• 额外传递noSearchCriteria标识位判断是否走无过滤逻辑属于冗余实现，完全可以通过参数空判断替代，维护成本更高

根据你使用的技术栈选对应实现即可，两种方案都能覆盖空参数、单值、多值三类场景，完全匹配需求。

方案1：修正原生SQL（适配JPA/MyBatis） #

不要在SQL里用IF硬写条件分支，直接用框架支持的集合空判断语法，让框架自动处理参数展开逻辑，修正后的SQL如下：

select distinct a.* 
from cust_enrollment_mgmt a 
inner join cust_enrollment_rel_mgmt r 
on a.cust_enrollment_proj_id=r.cust_enrollment_proj_id 
left join cust_prime p 
on p.cust_prime_id = r.cust_prime_id 
where 1=1
-- 固定生效的基础排除逻辑
and a.cust_enrollment_proj_id NOT IN 
( 
    select ce.cust_enrollment_proj_id 
    from cust_enrollment_mgmt ce 
    inner join enrollment_status_avt es 
    on ce.enrollment_status_id = es.enrollment_status_id 
    where ce.sys_update_ts < :archiveDate
    and es.enrollment_status_desc in :completedEnrollmentStatusCodes
)
-- 数据提供方过滤：参数为空时条件恒成立，不触发过滤
and ( :dataProviderCodes is empty or a.data_provider_cd in :dataProviderCodes )
-- 项目负责人过滤：参数为空时条件恒成立，不触发过滤
and ( :projectOwners is empty or p.cust_prime_nm in :projectOwners )

语法说明：:xxx is empty是JPA 2.1+、MyBatis均原生支持的集合空判断语法：

• 传入空集合时，对应条件直接返回true，不生效
• 传入单值/多值列表时，自动适配IN语法，不会出现解析错误
• 两个动态条件为AND关系，同时传参自动执行双条件匹配，均不传时仅执行基础过滤逻辑，不需要额外传递无搜索标识位。

方案2：Spring Data JPA 动态条件实现（无SQL解析风险） #

如果用Spring Data JPA，更推荐用Specification在Java层拼接动态条件，完全规避SQL层参数解析问题，代码可维护性更高：

1. 先让你的Repository接口继承JpaSpecificationExecutor<CustEnrollmentMgmt>
2. 直接在业务层构造查询条件，不需要在注解里写原生SQL：

custEnrollmentMgmts = customerEnrollmentManagementRepository.findAll((root, query, cb) -> {
    List<Predicate> predicates = new ArrayList<>();
    // 关联关联表
    Join<CustEnrollmentMgmt, CustEnrollmentRelMgmt> relJoin = root.join("custEnrollmentRelMgmt", JoinType.INNER);
    Join<CustEnrollmentRelMgmt, CustPrime> primeJoin = relJoin.join("custPrime", JoinType.LEFT);

    // 构造基础排除逻辑的子查询
    Subquery<Long> excludeSubQuery = query.subquery(Long.class);
    Root<CustEnrollmentMgmt> subRoot = excludeSubQuery.from(CustEnrollmentMgmt.class);
    Join<CustEnrollmentMgmt, EnrollmentStatusAvt> statusJoin = subRoot.join("enrollmentStatusAvt", JoinType.INNER);
    excludeSubQuery.select(subRoot.get("custEnrollmentProjId"))
            .where(
                    cb.lessThan(subRoot.get("sysUpdateTs"), getArchiveDate()),
                    statusJoin.get("enrollmentStatusDesc").in(completedEnrollmentStatusCodes)
            );
    predicates.add(cb.not(root.get("custEnrollmentProjId").in(excludeSubQuery)));

    // 非空才拼接数据提供方过滤条件
    if (dataProviderCodes != null && !dataProviderCodes.isEmpty()) {
        predicates.add(root.get("dataProviderCd").in(dataProviderCodes));
    }

    // 非空才拼接项目负责人过滤条件
    if (projectOwners != null && !projectOwners.isEmpty()) {
        predicates.add(primeJoin.get("custPrimeNm").in(projectOwners));
    }

    query.distinct(true);
    return cb.and(predicates.toArray(new Predicate[0]));
}, pageRequest);

• 这种写法完全在Java层做参数校验，不会出现多值参数解析失败的问题
• 去掉了冗余的getNoSearchCriteria逻辑，参数为空就不拼接对应条件，逻辑直观
• 相比SQL里写IF分支，这种写法不会影响数据库索引命中，查询性能更好

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