Spring Data R2DBC对接Oracle 11g时findById方法SQL语法错误求助

数据老陈

2026-8-20

问题分析与解决

问题原因

你遇到的SQL语法错误，根源在于Oracle 11g不支持FETCH FIRST 2 ROWS ONLY语法——这个写法是Oracle 12c及以上才引入的ANSI SQL兼容语法。

Spring Data R2DBC为findById、selectOne这类"单结果查询"自动添加限制行数的逻辑，目的是避免返回多条数据，但它默认生成ANSI标准的FETCH FIRST语法，没有适配Oracle 11g的特性。

解决方案

1. 配置Oracle 11g专用方言

在Spring Boot配置文件中指定R2DBC方言为Oracle 11g版本，让框架自动生成适配11g的SQL：

application.yml：

spring:
  r2dbc:
    dialect: oracle11

application.properties：

spring.r2dbc.dialect=oracle11

配置生效后，框架会把限制行数的逻辑替换为Oracle 11g支持的ROWNUM <= 1写法。

2. 自定义原生SQL查询

如果方言配置不生效，或者需要更灵活的控制，可以在Repository中自定义findById方法，手动编写适配SQL：

public interface ReactiveGamePhaseRepository extends R2dbcRepository<GamePhase, Long> {

    @Query("SELECT GAME_PHASE.* FROM GAME_PHASE WHERE GAME_PHASE.ID = :id AND ROWNUM <= 1")
    Mono<GamePhase> findById(Long id);
}

针对R2dbcEntityTemplate的场景，同样改用原生SQL查询：

r2dbcEntityTemplate.sql("SELECT * FROM GAME_PHASE WHERE ID = :id AND ROWNUM <= 1")
                  .bind("id", id)
                  .map(GamePhase.class)
                  .first();