从关键来看。命名策略

SprintPhysicalNamingStrategy 会把实体属性的 camelCase 自动转成 snake_case：

• 实体字段 createTime → 数据库列 createtime
• 实体字段 roleId → 数据库列 roleid
<\/ul>

If your legacy database uses camelCase column names,you must eir annotate each field with @Column or disable naming strategy globally .

. 主要来了：JPA 的三层结构

The classic “点菜” analogy helps you map layers to real roles:

="" →="" 接收="" 请求="" 调用="">
Service → 业务流程控制、事务、缓存 → 调用 Repository
Repository → extends JpaRepository，无需手写单表 CRUD
<\/ pre>

与 MyBatis‑Plus 的区别：

• JPA ：ORM 黑盒，由 Hibernate 自动生成 SQL，你看不到也管不了——但可以通过 show‑sql 查看；复杂查询使用 @Query 编写 JPQL 或原生 SQL。
• MyBatis‑Plus ：SQL友好。默认 CRUD 一样免写，但复杂查询直接在注解 @Select 或 XML 中编写——所见即所得。
<\/ul>

各自适合什么场景？

再看你的业务，├─ 大量 CRUD、使用者、权限、字典等规整业务 → 使用 JPA
├─ 多表联查、报表、大数据统计等复杂查询 → 使用 MyBatis‑Plus
└─ 两者都有需求 → 同项目混用：简单表交给 JPA。复杂查询交给 MyBatis
<\/ pre>

派生查询会生成什么样的真实 SQL？

在 Repository 中声明方法名即可让 Hibernate 自动拼装对应的 SELECT：

. JPARoleEntity findByName;

-- Hibernate 自动生成：
select jparoleent0.id as id10,jparoleent0.code as code20,jparoleent0.createtime as createt30。jparoleent0.description as descript40,jparoleent0.modifytime as modifyt50,jparoleent0.name as name60,jparoleent0.status as status70_
from studyjparole jparoleent0_
where jparoleent0_.name =?limit，-- 参数顺序为 name,limit
<\/ pre>

. List findRoleEntitiesByName;

select jparoleent0.id as id10,...
from studyjparole jparoleent0
where jparoleent0_.name =?<\/ pre>

. 模糊查询

@Query")
List findByCodeLike String code);<\/ pre>

注意：Hibernate 输出的别名如 jparoleent0_。id1_0_ 等是内部实现细节，不影响执行。开启 `show-sql:true` 和 `format_sql:true` 能在控制台看到美化后的完整语句。

<\/ blockquote>

常见痛点及方法

• 不知道该选 JPA 还是 MyBatis – 把业务划分为“CRUD 主导” vs “报表/统计”。先用 JPA 快速搭建，再在需要精准控制SQL时引入 MyBatis‑Plus，两者共存无冲突。
• 启动报错找不到实体 – 检查 @Entity 注解是否在扫描方法下；确保 spring.jpa.hibernate.naming.physical-strategy 与数据库命名保持一致。
• 命名策略导致字段不匹配 – 若数据库列是驼峰，请关闭默认 PhysicalNamingStrategy 或在字段上使用 @Column 覆盖。其实，
• 看不到真正执行的 SQL – spring.jpa.show-sql=true + spring.jpa.properties.hibernate.format_sql=true 是必备；按理说，配合日志级别 logging.level.org.hibernate.SQL=DEBUG 获得完整占位符值。
• DDL 自动更新意外删库 – 建议生产环境使用 ddl-auto:none 并配合 Flyway/Liquibase；本地调试可临时切换为 update 或 create-drop。
<\/ul>