本文介绍如何在 Spring Data JPA 中高效提取字符串类型日期字段的年份部分，并以 List<Integer> 形式按降序返回，兼顾可移植性与简洁性。
本文介绍如何在 spring data jpa 中高效提取字符串类型日期字段的年份部分，并以 `list
在实际开发中，若 Expensive 实体的 date 字段被定义为字符串类型（如 "2023-01-01"），直接使用数据库原生函数（如 DATE_PART）虽可行，但会牺牲 JPA 的数据库可移植性——不同 RDBMS（PostgreSQL、MySQL、H2 等）对日期解析函数的支持差异较大。
更推荐采用 纯 JPQL + 字符串截取 的方式，既避免 nativeQuery = true 带来的耦合，又无需修改实体字段类型。由于 ISO 格式日期（YYYY-MM-DD）的年份始终位于前 4 位，可安全使用 SUBSTRING(e.date, 1, 4) 提取：
@Query("SELECT DISTINCT SUBSTRING(e.date, 1, 4) " +
"FROM Expensive e " +
"WHERE e.userId = :userId AND e.date IS NOT NULL " +
"ORDER BY SUBSTRING(e.date, 1, 4) DESC")
List<String> findDistinctYearsAsString(@Param("userId") Long userId);⚠️ 注意：上述方法返回的是 List<String>（如 ["2023", "2022"]）。若业务强依赖 List<Integer>，需在服务层转换：
public List<Integer> getDistinctYears(Long userId) {
return findDistinctYearsAsString(userId)
.stream()
.map(Integer::parseInt)
.collect(Collectors.toList());
}✅ 优势总结：
- ✅ 完全基于 JPQL，兼容 H2（测试）、MySQL、PostgreSQL、Oracle 等主流数据库；
- ✅ 避免 CAST(... AS DATE) 可能引发的格式异常（尤其当 date 字段含非法值时）；
- ✅ 语义清晰、易于维护，无需编写数据库特定方言；
? 进阶建议：
长远来看，应将 date 字段重构为 LocalDate 类型，并添加 @Column(columnDefinition = "DATE") 注解。此时可直接使用 JPA 标准函数：
@Query("SELECT DISTINCT FUNCTION('year', e.date) FROM Expensive e WHERE e.userId = :userId ORDER BY FUNCTION('year', e.date) DESC")
List<Integer> findDistinctYearsByFunction(@Param("userId") Long userId);但该写法仍存在数据库兼容性风险（FUNCTION('year', ...) 并非 JPA 标准），因此优先推荐字符串截取方案作为稳健实践。
