IDEA 官宣：解放双手，Spring Data JDBC 从此不再“手搓”！

以前用 Spring Data JDBC 要手动写实体、改表、对字段？现在 IntelliJ IDEA 一键生成、双向同步、智能迁移——像 JPA 一样丝滑，但更轻量！

Spring Data JDBC 作为 Spring 官方推出的轻量级 ORM 方案，因其无代理、无懒加载、贴近 SQL 本质的特性，越来越受追求性能与可控性的团队青睐。
但长期以来，它在 IDE 支持上远不如 JPA —— 直到 IntelliJ IDEA 2025.3 带来了原生级 Spring Data JDBC 支持！

从此，无论是 DB-first（数据库先行） 还是 Code-first（代码先行），你都能享受和 JPA 一样的开发体验。

---

🚀 为什么需要 Spring Data JDBC？

对比项	Spring Data JPA	Spring Data JDBC
复杂度	高（Hibernate + 代理 + 缓存）	低（直接映射，无魔法）
性能	可能因懒加载/N+1 拖慢	可预测、接近原生 JDBC
调试难度	高（SQL 不透明）	低（SQL 清晰可见）
适用场景	复杂业务模型、强关联	简单聚合、高性能读写、微服务

💡 核心理念：Spring Data JDBC 遵循 DDD（领域驱动设计），强调“聚合根”边界，避免过度关联。

但过去，它的最大痛点是：缺乏工具链支持。
现在，IDEA 补上了这块拼图！

---

🛠️ IDEA 2025.3 新增能力一览

✅ 1. 自动识别 Spring Data JDBC 实体

只要你的类包含 @Id（来自 org.springframework.data.annotation.Id），IDEA 就会自动将其识别为实体，并提供：

• 字段导航
• Repository 方法补全
• 聚合根边界检查

@Table("students")
public class Student {
    @Id
    private Long id;
    private String name;
    private String email;
}

⚠️ 注意：如果使用 Java Record，需显式加 @Table 注解，否则可能无法识别。

---

✅ 2. 数据库 → 实体：一键反向生成（DB-first）

操作路径：
Database 工具窗口 → 右键数据源 → “Create JDBC Entities from DB…”

• 支持批量选择表
• 自动处理外键关系
• 复合主键自动生成嵌入类

例如，enrollments 表（含 (student_id, course_id) 复合主键）会生成：

public class EnrollmentId {
    private Integer studentId;
    private Integer courseId;
}

@Table("enrollments")
public class Enrollment {
    @Id
    @Embedded.Nullable
    private EnrollmentId id;
    private Instant enrolledAt;
}

---

✅ 3. 实体 → 数据库：自动生成 Flyway / Liquibase 迁移（Code-first）

操作路径：
在实体类旁点击 gutter 图标（小灯泡）→ “Generate Flyway Migration”

IDEA 会智能对比当前实体与数据库结构，生成差异脚本，并用颜色标记风险等级：

• 🟢 绿色：安全操作（如新增表、列）
• 🟡 黄色：需注意（如重命名列、修改类型）
• 🔴 红色：危险操作（如删除列、丢数据）

✅ 最佳实践：所有生成的迁移脚本都应人工复核后再部署！

---

✅ 4. 智能 Repository 方法补全

输入 findByEmail，IDEA 会自动提示并生成方法：

public interface StudentRepository extends CrudRepository<Student, Long> {
    // 无需手动写实现！
    Optional<Student> findByEmail(String email);
}

甚至支持：

• findByCourseName
• deleteByEnrolledAtBefore
• countBy...

只要符合 Spring Data 命名规范，IDEA 就能自动补全 + 即时创建。

---

✅ 5. 聚合根边界检查（DDD 友好）

Spring Data JDBC 要求每个实体只能属于一个聚合根。
IDEA 会自动检测违规引用，并给出警告：

⚠️ “Entity ‘Enrollment’ is referenced by multiple aggregates.”

并提供快速修复建议，帮你守住 DDD 设计原则。

---

🔄 两种工作流，任你选择

🗃️ DB-first：已有数据库？反向生成实体！

适合：

• 遗留系统改造
• DBA 主导建模

流程：

1. 连接数据库（IDEA 支持从 application.yml 自动注册）
2. 右键 → 生成实体
3. 编写业务逻辑

---

💻 Code-first：先写领域模型？自动生成迁移！

适合：

• 新项目启动
• DDD 实践团队

流程：

1. 定义 @Table 实体
2. 使用 gutter 图标生成 Flyway/Liquibase 脚本
3. 应用迁移，启动应用

💡 小技巧：AI 可用于“设计草稿”，但最终代码应由 IDEA 确定性生成，避免幻觉风险。

---

🧪 实战示例：三步搞定学生选课系统

假设我们有三张表：courses、students、enrollments。

步骤 1：连接数据库

• 在 Database 工具窗口添加 MySQL 数据源
• 或直接从 application.properties 拖拽配置

步骤 2：生成实体

• 右键 → “Create JDBC Entities from DB…”
• 选择三张表 → 生成 Course, Student, Enrollment

步骤 3：创建 Repository 并注入

@Service
public class EnrollmentService {
    // 输入 "enrollmentRepo"，IDEA 自动创建并注入！
    private final EnrollmentRepository enrollmentRepo;
    
    public void enroll(Long studentId, Long courseId) {
        var id = new EnrollmentId(studentId, courseId);
        enrollmentRepo.save(new Enrollment(id, Instant.now()));
    }
}

全程无需手写 SQL、无需配置映射、无需担心字段错位！

---

⚠️ 当前限制 & 注意事项

功能	支持情况
Record + @Id 自动识别	❌ 需加 @Table
复杂嵌套对象映射	⚠️ 仅支持简单嵌入（@Embedded）
自动生成 JOIN 查询	❌ Spring Data JDBC 本身不支持，需手写
与 JPA 混用	✅ 支持，但需注意事务隔离

📌 核心原则：IDEA 不替你做“不可能的事”，只帮你自动化确定性操作。

---

🔚 结语：轻量 ORM 的春天来了

Spring Data JDBC 一直是个“叫好不叫座”的技术 —— 因为太“裸”了。
现在，IntelliJ IDEA 2025.3 为它披上了现代化开发体验的外衣：

• DB-first？一键反向工程。
• Code-first？智能迁移生成。
• 日常 CRUD？Repository 方法秒补全。
• DDD 实践？聚合根边界自动守护。

🎯 推荐场景：微服务、事件溯源、CQRS、高并发读写、审计日志等对“可控性”要求高的系统。

如果你厌倦了 Hibernate 的黑盒，又不想退回纯 MyBatis 手写 SQL ——
Spring Data JDBC + IntelliJ IDEA 2025.3，就是你的新答案。

---