MySQL + JPA不是一种技术，而是「用 JPA 规范操作 MySQL 数据库」的组合方案。JPA 本身是 Java 的 ORM 接口标准（不是实现），真正干活的是 Hibernate、EclipseLink 这类实现；而 MySQL 是它背后连接的数据库。你写的实体类、注解、CRUD 逻辑，最终由 JPA 实现层翻译成 MySQL 能执行的 SQL。
实体类怎么映射到 MySQL 表？关键就三步
映射不是自动猜的，得靠明确注解告诉 JPA「这个类对应哪张表」「哪个字段是主键」「哪个列叫什么名」：
@Entity：声明这是一个实体类 —— 没它，JPA 完全不认这个类是“能存数据库的”
@Table(name = "user_info")：显式指定 MySQL 表名；不写时默认按类名转
snake_case（如
User→
user），但实际项目中强烈建议写死，避免命名歧义
@Id+
@GeneratedValue(strategy = GenerationType.IDENTITY)：MySQL 主键必须用
IDENTITY（自增），因为 MySQL 不支持
SEQUENCE；
AUTO虽然可用，但底层仍会 fallback 到
IDENTITY，不如直接写明更清晰
@Entity
@Table(name = "user_info")
public class User {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
<pre class='brush:php;toolbar:false;'>@Column(name = "user_name", nullable = false, length = 50)
private String username;
@Column(name = "created_at")
private LocalDateTime createdAt;}
@Column 哪些属性在 MySQL 场景下最常用？
MySQL 对字段定义敏感，
@Column不只是改名字，它直接影响建表语句和运行时行为：
name：强制对齐 MySQL 列名（比如 Java 用
userName，MySQL 习惯
user_name）
nullable = false：生成
NOT NULL约束，否则 JPA 默认允许
NULL，容易导致插入失败
length = 64：对
String必须设（MySQL 的
VARCHAR需要长度），不设可能被 Hibernate 默认为
VARCHAR(255)，浪费空间或触发隐式截断
columnDefinition = "datetime DEFAULT CURRENT_TIMESTAMP"：绕过 JPA 抽象层，直写 MySQL 原生定义（慎用，牺牲移植性）
⚠️ 注意：
@Column放在字段上 or getter 上均可，但**不能混用** —— 同一个属性上字段和 getter 都加注解会报
PersistenceException。
MySQL 主键策略选错会直接报错
常见错误现象：
org.hibernate.MappingException: Could not determine type for: java.lang.Long或启动时报
IdentifierGenerationException，往往是因为主键配置和 MySQL 特性不匹配：
GenerationType.IDENTITY✅：唯一推荐给 MySQL 的策略，依赖
auto_increment字段，要求数据库表已建好且主键设为自增
GenerationType.TABLE⚠️：虽可跨库，但需额外建一张
hibernate_sequences表，MySQL 下性能略低，且
allocationSize设错会导致 ID 跳号（如设 50，每次取一段）
GenerationType.SEQUENCE❌：MySQL 原生无
SEQUENCE对象，Hibernate 会模拟成表，但行为不标准，官方文档已标记为“不推荐用于 MySQL”
? 小技巧：如果要用 UUID 当主键（字符串类型），别用
@GeneratedValue，改用
@GenericGenerator或手动赋值 —— MySQL 的
CHAR(36)主键索引效率远低于
BIGINT，除非业务强需求。
JPA 自动生成表（ddl-auto: update
）在 MySQL 中的真实表现
开发阶段开
spring.jpa.hibernate.ddl-auto=update很方便，但它在 MySQL 上有严重限制： 只支持「新增字段」「扩大字段长度」「加非空约束（已有数据为空时失败）」 不支持删字段、改字段类型、删表、重命名列 —— 这些操作会被静默忽略，不会报错，但你的实体和表结构就悄悄不一致了 遇到
ALTER TABLE ... MODIFY COLUMN失败（比如从
VARCHAR(50)缩小到
VARCHAR(20)），整个更新中断，后续变更不执行
✅ 正确做法：本地开发可用
update，但测试/生产环境必须关掉（设为
validate或
none），用 Flyway/Liquibase 管理 DDL 变更。
最常被忽略的一点：MySQL 的
utf8mb4编码和排序规则（如
utf8mb4_0900_as_cs）不会被 JPA 自动设置，得在 JDBC URL 里加参数：
?characterEncoding=utf8mb4&serverTimezone=UTC，否则中文存成问号或报错。
