Java Spring Boot中如何实现GET接口可选请求参数动态查询

@RequestParam(required = false)配置本身是生效的，它只是让Spring MVC在接收请求时不强制要求参数必须传递，接口报错/查询结果不符合预期是另外两个逻辑问题导致的：

• 枚举转换逻辑没有做空判断：当参数未传递时入参值为null，直接调用CloudEnum.valueOf(cloud)、Regions.valueOf(region)会直接抛出空指针或非法参数异常
• Repository层的派生查询方法不支持动态条件：findByCloudAndRegionAndCustomerNameAndSfSan会默认生成四个字段全匹配的SQL，传入null时会执行字段 = NULL的查询（SQL里= NULL永远不会命中结果），不会自动忽略空参数。

1. 调整Controller层参数转换逻辑 #

转换枚举前先判空，把空串、未传的参数统一处理为null，避免转换报错：

import org.springframework.util.StringUtils;

// 省略方法注解和参数定义
public ResponseEntity<?> findTenantsByCloudAndRegionAndCustomerNameAndSAN(
        @RequestParam(required = false) String cloud,
        @RequestParam(required = false) String region,
        @RequestParam(required = false) String customerName,
        @RequestParam(required = false) String sfSan ) {

    // 空值安全的参数转换
    CloudEnum cloudEnum = StringUtils.hasText(cloud) ? CloudEnum.valueOf(cloud) : null;
    Regions regionEnum = StringUtils.hasText(region) ? Regions.valueOf(region) : null;
    String finalCustomerName = StringUtils.hasText(customerName) ? customerName : null;
    String finalSfSan = StringUtils.hasText(sfSan) ? sfSan : null;

    List<Tenant> tenantList  = tenantRepository.findTenantsByDynamicCondition(cloudEnum, regionEnum, finalCustomerName, finalSfSan);
            
    return ResponseEntity.ok(tenantList);     
}

2. 改造Repository方法支持动态条件过滤 #

用JPQL写动态条件逻辑，参数为null时自动跳过对应字段的过滤，支持任意参数组合查询：

public interface TenantRepository extends JpaRepository<Tenant, Long> {
    @Query("SELECT t FROM Tenant t WHERE " +
            "(:cloud IS NULL OR t.cloud = :cloud) AND " +
            "(:region IS NULL OR t.region = :region) AND " +
            "(:customerName IS NULL OR t.customerName = :customerName) AND " +
            "(:sfSan IS NULL OR t.sfSan = :sfSan)")
    List<Tenant> findTenantsByDynamicCondition(
            @Param("cloud") CloudEnum cloud,
            @Param("region") Regions region,
            @Param("customerName") String customerName,
            @Param("sfSan") String sfSan
    );
}

• 不要用null直接调用枚举的valueOf方法，未做判空的转换是接口报500错误的核心原因
• 用Spring自带的StringUtils.hasText()做判空，可以同时处理参数未传（null）、传空串、传全空格字符串三种场景
• 改造完成后支持任意参数组合查询：不传参返回全量租户、只传region=CA_CENTRAL_1就返回对应区域的租户、传多个参数就按多条件AND匹配
• 如果后续需要支持模糊搜索，只需要把JPQL中对应字段的=改为LIKE，传参时拼接%通配符即可

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