Firebird双括号子查询引发单行选择多行错误问题咨询

问题原因 #

Firebird 4及2.5版本对IN子句的括号解析有特殊逻辑：

• 当子查询被双层括号包裹时（IN ((select ...))），Firebird会将其判定为单值子查询，要求子查询只能返回一行一列。一旦子查询返回多行，就会触发multiple rows in singleton select错误。
• 而单层括号的写法（IN (select ...)）会被正确识别为多行匹配的子查询，能正常处理多行结果。

可行解决方案 #

由于SQL由Spring Data Criteria API自动生成，无法直接控制括号数量，可通过以下方式解决：

• 自定义Hibernate Dialect（适用于Hibernate作为JPA实现）
  扩展Firebird的方言类，重写IN表达式的渲染逻辑，自动移除子查询外层多余的括号：

  public class CustomFirebirdDialect extends FirebirdDialect {
      @Override
      public String renderInExpression(String column, String subquery) {
          // 剔除子查询外层的重复括号
          if (subquery.startsWith("((") && subquery.endsWith("))")) {
              subquery = subquery.substring(1, subquery.length() - 1);
          }
          return super.renderInExpression(column, subquery);
      }
  }
  

  然后在Spring配置文件中指定使用自定义方言：

  spring.jpa.properties.hibernate.dialect=你的包路径.CustomFirebirdDialect
  

• 改用@Query手动编写SQL
  对涉及IN子查询的查询方法，绕过Criteria API，直接用@Query编写正确的单层括号SQL：

  @Query("SELECT r FROM RdbRelations r WHERE r.relationId IN (SELECT rel.relationId FROM RdbRelations rel)")
  List<RdbRelations> findAllRelations();
  

• 调整Criteria API构建逻辑
  若必须使用Criteria API，避免生成嵌套括号的子查询写法，直接将子查询对象传入in()方法：

  CriteriaBuilder cb = entityManager.getCriteriaBuilder();
  CriteriaQuery<RdbRelations> query = cb.createQuery(RdbRelations.class);
  Root<RdbRelations> root = query.from(RdbRelations.class);
  
  Subquery<Long> subquery = query.subquery(Long.class);
  Root<RdbRelations> subRoot = subquery.from(RdbRelations.class);
  subquery.select(subRoot.get("relationId"));
  
  // 直接传入subquery，不额外包裹括号
  query.where(root.get("relationId").in(subquery));
  

  这种写法生成的SQL会是单层括号的IN子查询，符合Firebird的要求。

报错信息：
SQL Error [335544652] [21000]: multiple rows in singleton select [SQLState:21000, ISC error code:335544652]

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