本文解决 spring boot 2.x + r2dbc + postgresql 项目中调用 `findbyid()` 报错 `required identifier property not found` 的核心原因：`@id` 注解误用及数据库列名与实体字段大小写不匹配。
在基于 Spring WebFlux 与 R2DBC 构建响应式数据访问层时，开发者常误将 JPA 的 javax.persistence.Id 注解用于 R2DBC 实体——这是导致 IllegalStateException: Required identifier property not found for class com.springboot2.domain.ToDo 报错的最常见根源。R2DBC 作为 Spring Data 的独立模块，严格依赖 Spring Data 自身的元数据注解体系，而非 JPA 规范。
✅ 正确的 @Id 注解必须来自 Spring Data
请确保你的实体类中导入的是：
import org.springframework.data.annotation.Id; // ✅ 正确：Spring Data 原生支持
而非：
import javax.persistence.Id; // ❌ 错误：JPA 注解，R2DBC 不识别
修改后，实体 ToDo 的 id 字段声明应为：
@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;
// 构造器、getter/setter（Lombok 已覆盖）
}⚠️ 补充说明：@Version 在 R2DBC 中需配合 @EnableR2dbcAuditing 启用，且要求数据库列类型为 BIGINT（非 SERIAL 或 INTEGER），否则会写入 NULL。当前 SQL 中 version BIGINT 定义正确，但需确认插入/更新操作是否触发了审计逻辑（如使用 R2dbcEntityTemplate 或继承 ReactiveAuditingEntityListener）。
✅ 数据库列名与实体字段名需大小写一致或显式映射
PostgreSQL 默认将未加引号的标识符转为小写。你在建表语句中使用了大写 ID：
CREATE TABLE to_do (
ID SERIAL PRIMARY KEY, -- ← PostgreSQL 将其视为小写 "id"？否！加引号后为严格大写
version bigint,
description char(255),
created timestamp,
modified timestamp,
completed boolean
);由于 ID 被双引号包裹（"ID"），PostgreSQL 会严格区分大小写，将其视为名为 ID（全大写）的列。而 Spring Data R2DBC 默认按驼峰转下划线规则映射字段（如 id → id），无法自动匹配 ID。
解决方案（二选一）：
✅ 推荐方案：统一使用小写列名（符合 PostgreSQL 惯例）
修改建表语句，移除引号，让 PostgreSQL 自动标准化为小写：
CREATE TABLE to_do (
id SERIAL PRIMARY KEY, -- ✅ 小写，R2DBC 默认识别
version BIGINT,
description VARCHAR(255), -- 改用 VARCHAR 更合理
created TIMESTAMP,
modified TIMESTAMP,
completed BOOLEAN
);✅ 备选方案：通过 @Column 显式指定列名
若必须保留大写 ID，则在实体中明确绑定：
@Table(name = "to_do")
public class ToDo {
@Id
@Column("ID") // ✅ 强制映射到数据库列 "ID"
private Long id;
// 其他字段...
}? 验证技巧：启动应用时添加日志级别 logging.level.org.springframework.data.r2dbc=DEBUG，可观察实际执行的 SQL 及列映射行为。
✅ 依赖版本兼容性检查（关键！）
你当前的 pom.xml 存在严重版本冲突风险：
- spring-boot-starter-data-r2dbc（2.7.3）默认集成 R2DBC SPI 0.9.x
- 但手动引入了过时的 r2dbc-postgresql:0.8.1.RELEASE（对应旧版 SPI 0.8.x）
这将导致运行时 ClassCastException 或连接初始化失败。必须移除手动版本声明，交由 Spring Boot 父 POM 统一管理：
<!-- ❌ 删除此行（版本由 Spring Boot 2.7.3 自动匹配） -->
<!-- <version>0.8.1.RELEASE</version> -->
<dependency>
<groupId>io.r2dbc</groupId>
<artifactId>r2dbc-postgresql</artifactId>
<!-- ✅ 无 version 标签，由 spring-boot-dependencies 控制 -->
</dependency>同时，务必移除 spring-boot-starter-data-jpa：
R2DBC 与 JPA 不可共存于同一实体模型。spring-boot-starter-data-jpa 会激活 Hibernate 元数据扫描，干扰 R2DBC 的 @Id 解析逻辑，加剧上述异常。仅保留：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-r2dbc</artifactId>
</dependency>
<dependency>
<groupId>io.r2dbc</groupId>
<artifactId>r2dbc-postgresql</artifactId>
</dependency>✅ 最终验证步骤
- 清理并重建数据库表（使用小写 id 列）；
- 确保 ToDo 类中 @Id 来自 org.springframework.data.annotation.Id；
- 移除 spring-boot-starter-data-jpa 依赖；
- 删除 r2dbc-postgresql 的硬编码版本；
- 重启应用，发起请求：GET http://localhost:8080/api/v1/to-do/3。
此时 repository.findById(toDoId) 将正常返回 Mono
? 总结：R2DBC 的稳定性高度依赖“约定优于配置”的一致性——包括注解来源、命名规范、依赖版本三者统一。一次精准的 @Id 修正，往往能避免 80% 的响应式数据访问故障。
