本文解决 spring boot 2.x + r2dbc + postgresql 项目中调用 `findbyid()` 报错 `required identifier property not found for class` 的核心原因：`@id` 注解误用及数据库列名与实体字段名大小写不一致。
在基于 Spring WebFlux 与 R2DBC 构建响应式数据访问层时，开发者常误将 JPA 的注解体系直接套用于 R2DBC 场景。典型表现是：GET /api/v1/to-do/3 接口抛出 IllegalStateException: Required identifier property not found for class com.springboot2.domain.ToDo —— 这并非数据库连接或 SQL 语法错误，而是 Spring Data R2DBC 在反射解析实体元数据时，未能识别主键字段所致。
根本原因分析
该异常由两个紧密关联的问题共同触发：
-
错误的 @Id 注解导入
R2DBC 要求使用 Spring Data 自带的标识注解：
✅ 正确：org.springframework.data.annotation.Id
❌ 错误：javax.persistence.Id（属于 JPA 规范，R2DBC 不识别）若误用 JPA 的 @Id，R2dbcMappingContext 在构建 PersistentEntity 时无法识别主键属性，导致 getIdentifierAccessor() 返回空，最终抛出上述异常。
-
数据库列名与实体字段名大小写不匹配
表定义中主键列为大写 ID：CREATE TABLE to_do (ID SERIAL PRIMARY KEY, ...);
而实体字段为小写 id：
@Id private Long id; // ← 映射到列 "id"，但实际列名为 "ID"
PostgreSQL 默认对未加引号的标识符转为小写，但显式大写声明（如 "ID" 或 ID）在非 quoted 模式下仍被视作大写。R2DBC 默认按严格字面匹配查找列名，若实体字段 id 对应的列在数据库中为 ID，且未显式指定列映射，则自动映射失败。
解决方案
✅ 步骤一：修正 @Id 注解来源
确保实体类中使用 Spring Data 注解：
import org.springframework.data.annotation.Id; // 关键！非 javax.persistence.Id
@Data
@RequiredArgsConstructor
@Table(name = "to_do")
public class ToDo {
@Id // ← 必须来自 org.springframework.data.annotation.Id
private Long id;
@Version
private Long version;
@NotNull
@NotBlank
private String description;
@CreatedDate
private Timestamp created;
@LastModifiedDate
private Timestamp modified;
private boolean completed;
}✅ 步骤二：统一列名映射（推荐显式声明）
方式 A：修改建表语句（推荐，符合 PostgreSQL 惯例）
将列名改为小写，避免大小写歧义：
CREATE TABLE to_do (
id SERIAL PRIMARY KEY, -- 小写 id
version BIGINT,
description VARCHAR(255), -- 改用 VARCHAR 更合理
created TIMESTAMP,
modified TIMESTAMP,
completed BOOLEAN
);方式 B：在实体中显式绑定列名（兼容现有大写表结构）
import org.springframework.data.relational.core.mapping.Column;
@Data
@RequiredArgsConstructor
@Table(name = "to_do")
public class ToDo {
@Id
@Column("ID") // ← 显式指定对应数据库列名为 "ID"
private Long id;
@Column("version")
private Long version;
@Column("description")
private String description;
@Column("created")
private Timestamp created;
@Column("modified")
private Timestamp modified;
@Column("completed")
private Boolean completed;
}⚠️ 注意：@Column 注解需配合 org.springframework.data.relational.core.mapping.Column，而非 JPA 的 javax.persistence.Column。
✅ 步骤三：验证 @Version 等审计字段行为
R2DBC 审计支持依赖于 R2dbcAuditingRegistrar，需确认配置生效：
- 已添加 @EnableR2dbcAuditing（代码中已有）
- 实体中 @Version 字段类型应为 Long（已满足）
- 若仍写入 NULL，检查是否遗漏 @EnableR2dbcAuditing 的 auditorAwareRef 配置（无登录上下文时可设默认值），或确认数据库列允许 NULL（首次插入时版本为 0 或 1，需初始化）
补充：Maven 依赖建议（兼容性关键）
您当前 pom.xml 中存在潜在冲突风险：
- 同时引入 spring-boot-starter-data-jpa 和 spring-boot-starter-data-r2dbc：JPA 与 R2DBC 元数据处理器可能干扰；
- r2dbc-postgresql 版本 0.8.1.RELEASE 较旧，与 Spring Boot 2.7.3 不完全对齐。
✅ 推荐精简并升级依赖：
<!-- 移除 JPA starter -->
<!-- <dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency> -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-r2dbc</artifactId>
</dependency>
<dependency>
<groupId>io.r2dbc</groupId>
<artifactId>r2dbc-postgresql</artifactId>
<!-- 使用与 Spring Boot 2.7.x 匹配的版本 -->
<version>0.9.1.RELEASE</version>
</dependency>总结
| 问题现象 | 根本原因 | 修复动作 |
|---|---|---|
| Required identifier property not found | @Id 来自 javax.persistence，非 Spring Data R2DBC 识别范围 | 替换为 org.springframework.data.annotation.Id |
| findById() 返回空或报错 | 实体字段 id 未映射到数据库列 ID（大小写敏感） | 建表改小写 id，或用 @Column("ID") 显式绑定 |
| @Version 写入 NULL | 审计配置未生效或数据库列约束阻止默认值 | 检查 @EnableR2dbcAuditing、列 NOT NULL 约束及初始化逻辑 |
完成以上调整后，GET /api/v1/to-do/3 将正常返回对应记录，repository.findById(id) 可稳定工作。R2DBC 的响应式特性得以真正释放——关键在于严格遵循其元数据约定，而非沿用 JPA 思维惯性。
