Spring WebFlux+R2DBC查询单条记录报错：找不到实体标识属性

1. 单条查询/删除报错：java.lang.IllegalStateException: Required identifier property not found for class com.springboot2.domain.ToDo #

这个错误的核心是R2DBC无法识别实体类的主键，导致无法基于ID执行单条操作，以下是排查修复点：

实体类必须标记主键字段 #

给实体类的主键字段加上@Id注解，且字段类型要和数据库表主键完全匹配：

@Table("todo")
public class ToDo {
    @Id
    private Long id; // 对应数据库表的id字段，类型保持一致
    // 其他字段...
}

如果没加@Id，R2DBC找不到标识符，必然抛出这个错误。

校验Repository方法签名 #

自定义Repository继承ReactiveCrudRepository时，单条操作的参数类型要和主键类型对齐：

public interface ToDoRepository extends ReactiveCrudRepository<ToDo, Long> {
    // 正确的单条查询写法
    Mono<ToDo> findById(Long id);
    // 正确的删除写法
    Mono<Void> deleteById(Long id);
}

参数类型不匹配也会触发标识符找不到的错误。

确认数据库表主键定义 #

建表SQL里必须明确主键字段，比如：

CREATE TABLE todo (
    id BIGSERIAL PRIMARY KEY, -- 主键字段，类型和实体类对应
    -- 其他字段...
);

2. @Version注解不生效，写入数据库时字段为null #

R2DBC乐观锁@Version生效需要满足三个条件：

实体类正确标记版本字段 #

给版本字段加上@Version注解，推荐用Integer或Long类型：

@Table("todo")
public class ToDo {
    @Id
    private Long id;
    @Version
    private Integer version; // 对应数据库的version字段
    // 其他字段...
}

数据库表存在对应version字段 #

建表SQL必须包含version字段，首次插入时R2DBC会自动设置初始值为1：

CREATE TABLE todo (
    id BIGSERIAL PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    completed BOOLEAN DEFAULT FALSE,
    version INT -- 必须存在该字段
);

依赖R2DBC自动更新机制 #

执行save()方法时，若实体id为null，R2DBC会执行插入并设置version为1；若id已存在，则执行更新并自动递增version。不要手动设置version值，否则会破坏乐观锁逻辑。

额外注意点 #

• 确保Spring Boot和R2DBC驱动版本兼容，pom.xml中依赖示例：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-r2dbc</artifactId>
</dependency>
<dependency>
    <groupId>io.r2dbc</groupId>
    <artifactId>r2dbc-postgresql</artifactId>
    <scope>runtime</scope>
</dependency>

• 自定义@Query查询时，必须包含id和version字段，比如：

@Query("SELECT id, title, completed, version FROM todo WHERE id = :id")
Mono<ToDo> findCustomById(Long id);

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