Spring Data中根据运行时动态指定列名获取所有distinct值的实现方案

Spring Data 中预定义的查询方法、固定语句的@Query注解，默认无法支持运行时动态切换查询列名——JDBC层面的参数占位符只能绑定字面量值，不能绑定列名、表名这类数据库元数据标识符，直接用参数传列名会直接触发语法错误。
实际开发中可以选择两种适配Spring Data生态的实现方案：

方案1：基于JPA Criteria + Specification 实现（推荐） #

这种方式完全在JPA规范体系内构造查询，不会脱离Spring Data的扩展能力，长期维护成本最低：

• 让对应实体的Repository接口额外继承JpaSpecificationExecutor，这是Spring Data JPA自带的扩展接口，不需要引入任何额外依赖。
• 构造查询逻辑时，将运行时传入的目标列名动态绑定到Criteria查询的select子句中，同时开启distinct去重标记：

// 预先维护允许查询的列名白名单，可从实体的字段映射关系中自动提取，避免非法列名触发运行时异常
private static final Set<String> ALLOWED_COLUMNS = Set.of("col1", "col2", "col3");

public List<Object> getDistinctValues(String targetColumnName) {
    // 先做列名合法性校验
    if (!ALLOWED_COLUMNS.contains(targetColumnName)) {
        throw new IllegalArgumentException("不支持查询该列的数据");
    }
    // 构造Specification动态查询
    Specification<YourEntity> querySpec = (root, criteriaQuery, criteriaBuilder) -> {
        // 动态绑定查询列，开启distinct去重
        criteriaQuery.select(root.get(targetColumnName)).distinct(true);
        return criteriaQuery.getRestriction();
    };
    // 调用Repository方法拿到查询结果
    return yourRepository.findAll(querySpec)
            .stream()
            .map(row -> row.get(targetColumnName))
            .toList();
}

这种实现的灵活性更高，后续可以随时叠加where过滤条件、分页、排序逻辑，和Spring Data原生的查询能力完全打通。

方案2：基于EntityManager的原生动态查询实现 #

如果不想依赖Specification的查询构造逻辑，可以直接注入EntityManager手动拼装原生SQL：

// 同样需要预先维护允许查询的列名白名单
private static final Set<String> ALLOWED_COLUMNS = Set.of("col1", "col2", "col3");
@PersistenceContext
private EntityManager entityManager;

public List<Object> getDistinctValuesByNativeSql(String targetColumnName) {
    if (!ALLOWED_COLUMNS.contains(targetColumnName)) {
        throw new IllegalArgumentException("不支持查询该列的数据");
    }
    // 列名属于数据库标识符，不能用JDBC占位符绑定，只能通过安全校验后的字符串拼接
    String querySql = String.format("SELECT DISTINCT %s FROM your_table_name", targetColumnName);
    return entityManager.createNativeQuery(querySql).getResultList();
}

核心避坑提示 #

• 所有动态传入的列名必须经过严格的白名单校验，不能直接使用外部透传的字符串作为查询列名，否则会直接触发SQL注入风险。
• 不要尝试用@Query的参数占位符传列名，类似SELECT DISTINCT :columnName FROM YourEntity的写法会把传入的列名当成固定常量值返回，不会识别为真实的表字段，完全达不到动态查询的效果。
• 动态生成的查询最终都会下推到数据库层执行，只要目标列配置了合适的索引，查询性能和固定列的手写查询没有差异。

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