使用JPA查询表名为SQL保留关键字的实体时如何替代原生查询？

可行解决方案（无需修改现有表名） #

核心思路是通过JPA配置/实体注解完成保留关键字的自动转义，不需要修改业务表名，也不需要依赖原生查询：

方案1：修改实体类注解完成表名转义（推荐，侵入性最小） #

你只需要调整Case实体类的@Entity和@Table注解，显式指定转义后的表名和自定义实体名，避免JPQL和SQL生成阶段触发保留关键字校验：

// 自定义实体名，避免JPQL中使用Case作为实体名触发关键字冲突
@Entity(name = "CaseEntity")
// 表名用双引号转义，JPA生成SQL时会自动携带转义符，适配大部分支持SQL标准的数据库
@Table(name = "\"case\"", schema = "cft")
public class Case {
    // 原有实体字段、Getter/Setter保持不变
}

调整后你的JPQL可以直接正常使用，不需要修改逻辑：

@Repository
public interface CaseRepository extends JpaRepository<Case, Long> {
      // 这里用自定义的实体名CaseEntity即可
      @Query("select c from CaseEntity c where c.id = :idCase")
      Case getCaseById(Long idCase);
}

如果使用MySQL数据库，转义符可以换成反引号：@Table(name = "case")；如果使用SQL Server，可以换成方括号：@Table(name = "[case]")

方案2：开启Hibernate全局标识符转义（适合存在多个保留关键字作为表/列名的场景） #

如果你用Hibernate作为JPA实现（Spring Data JPA默认使用Hibernate），可以直接在配置文件中开启全局转义，不需要修改每个实体的注解：

• application.properties配置：

# 自动给所有SQL标识符（表名、列名）添加转义符
spring.jpa.properties.hibernate.globally_quoted_identifiers=true
# 可选配置：避免列定义的SQL语句被重复转义
spring.jpa.properties.hibernate.globally_quoted_identifiers_skip_column_definitions=true

• application.yml配置：

spring:
  jpa:
    properties:
      hibernate:
        globally_quoted_identifiers: true
        globally_quoted_identifiers_skip_column_definitions: true

开启后只需要给Case实体自定义实体名避免JPQL冲突即可：

@Entity(name = "CaseEntity")
@Table(name = "case", schema = "cft")
public class Case {
    // 原有字段保持不变
}

Hibernate会自动在生成SQL时给case表名添加对应数据库的转义符，无需手动处理。

注意事项 #

1. 你之前的JPQL代码返回类型写为Cases，需要和实体类名保持一致改为Case，否则会触发类型不匹配错误。
2. 以上方案都不需要修改现有数据库表名，对现有业务逻辑无侵入。

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