Oracle JPA复合键配置与分页查询ORA-00933错误求助

错误根源 #

你遇到的ORA-00933错误，核心原因是Spring Data JPA自动拼接分页SQL时，与你的自定义查询语句语法冲突。因为返回List<Object[]>时不需要分页逻辑，SQL可以正常执行；但切换到Page<Object[]>并传入Pageable后，框架会自动在原SQL后追加Oracle分页相关语句（如FETCH NEXT ? ROWS ONLY或基于ROWNUM的子查询），如果原SQL存在语法瑕疵（比如末尾带分号），或者是原生SQL未正确配置计数查询，就会导致SQL命令格式错误。

复合键的正确配置（先确认基础配置无误） #

使用@IdClass定义复合键时，必须满足以下要求，否则会间接影响查询逻辑：

1. 定义独立的复合键类，实现Serializable接口；
2. 类中包含与实体类复合键字段完全同名的属性；
3. 重写equals()和hashCode()方法（JPA依赖这两个方法识别实体唯一性）；
4. 提供无参构造器。

示例代码 #

复合键类

public class MenuId implements Serializable {
    private String ymd;
    private String restaurant;
    private String mealType;
    private String food;

    // 无参构造器（必须）
    public MenuId() {}

    // 带参构造器（可选，便于使用）
    public MenuId(String ymd, String restaurant, String mealType, String food) {
        this.ymd = ymd;
        this.restaurant = restaurant;
        this.mealType = mealType;
        this.food = food;
    }

    // 重写equals和hashCode（必须）
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        MenuId menuId = (MenuId) o;
        return ymd.equals(menuId.ymd) &&
               restaurant.equals(menuId.restaurant) &&
               mealType.equals(menuId.mealType) &&
               food.equals(menuId.food);
    }

    @Override
    public int hashCode() {
        return Objects.hash(ymd, restaurant, mealType, food);
    }

    // getter、setter方法
}

实体类

@Entity
@IdClass(MenuId.class) // 指定复合键类
public class Menu {
    @Id
    private String ymd;
    @Id
    private String restaurant;
    @Id
    private String mealType;
    @Id
    private String food;

    // 其他业务字段及方法
}

分页查询的修复方案 #

根据你使用的查询类型（JPQL/原生SQL），分别处理：

1. 使用JPQL查询（推荐） #

如果你的自定义查询是JPQL而非原生SQL，直接修改返回类型为Page<Object[]>并传入Pageable即可，Spring Data JPA会自动生成兼容Oracle的分页SQL，无需手动处理：

@Repository
public interface MenuRepository extends JpaRepository<Menu, MenuId> {

    @Query("SELECT m.ymd, m.restaurant, m.mealType, m.food FROM Menu m WHERE m.restaurant = :restaurant")
    Page<Object[]> findByRestaurant(@Param("restaurant") String restaurant, Pageable pageable);
}

2. 使用原生SQL查询 #

若必须使用原生SQL，需注意两点：

• 原SQL末尾不能带分号，否则框架追加的分页语句会被放在分号后，导致语法错误；
• 必须显式指定countQuery，用于分页时的总条数统计（框架无法自动解析原生SQL的计数逻辑）。

示例代码：

@Repository
public interface MenuRepository extends JpaRepository<Menu, MenuId> {

    @Query(value = "SELECT m.ymd, m.restaurant, m.mealType, m.food FROM menu m WHERE m.restaurant = :restaurant",
           countQuery = "SELECT COUNT(*) FROM menu m WHERE m.restaurant = :restaurant",
           nativeQuery = true)
    Page<Object[]> findByRestaurantNative(@Param("restaurant") String restaurant, Pageable pageable);
}

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