java中无法直接通过自定义@table注解自动校验mysql表结构，但可通过自定义注解+启动扫描+jdbc元数据比对+ddl检查实现联合唯一约束声明与结构校验，关键在于分离“声明”和“执行”。
<p>Java 中无法直接在自定义 <code>@Table</code> 注解里“自动触发 JDBC 校验 MySQL 表结构”，因为注解本身只是元数据，不执行逻辑；但你可以设计一套可扩展的机制：自定义注解 + 启动时扫描 + JDBC 元数据比对 + DDL 检查，实现联合唯一约束声明与结构校验。关键在于分离“声明”和“执行”。</p>
<h3>一、定义支持联合唯一约束的自定义 @Table 注解</h3>
<p>标准 JPA 的 <code>@Table</code> 不支持联合唯一（仅 <code>@UniqueConstraint</code> 在 <code>@Entity</code> 上），所以需扩展：</p>
<font color="gray">
<pre class="brush:php;toolbar:false;">
@Target(ElementType.TYPE)
@Retention(RetentionPolicy.RUNTIME)
public @interface Table {
String name() default "";
UniqueConstraint[] uniqueConstraints() default {};
}
@Target({})
@Retention(RetentionPolicy.RUNTIME)
public @interface UniqueConstraint {
String[] columnNames(); // 如 {"user_id", "role_code"}
String name() default ""; // 可选：约束名，用于比对和报错定位
}
这样就能在实体类上写：
@Table(name = "user_role", uniqueConstraints = {
@UniqueConstraint(columnNames = {"user_id", "role_code"}),
@UniqueConstraint(columnNames = {"role_code", "tenant_id"}, name = "uk_role_tenant")
})
@Entity
public class UserRole { ... }
二、启动时扫描实体类并提取约束声明
用 Spring Boot 的 ApplicationContextInitializer 或 @PostConstruct（配合 ApplicationRunner）在容器刷新前扫描所有带 @Table 的实体类：
- 通过
ClassPathScanningCandidateComponentProvider扫描@Entity类 - 反射获取
@Table注解，解析出每个UniqueConstraint - 构建内存模型：
Map<String, List<Set<String>>>（表名 → 联合列名集合列表）
三、用 JDBC 查询 MySQL 现有唯一约束（含联合唯一）
MySQL 中联合唯一索引会记录在 INFORMATION_SCHEMA.STATISTICS，且 NON_UNIQUE = 0 表示唯一索引：
SELECT TABLE_NAME, INDEX_NAME, GROUP_CONCAT(COLUMN_NAME ORDER BY SEQ_IN_INDEX) AS columns FROM INFORMATION_SCHEMA.STATISTICS WHERE TABLE_SCHEMA = ? AND NON_UNIQUE = 0 GROUP BY TABLE_NAME, INDEX_NAME;
注意点：
- MySQL 的联合唯一约束底层是唯一索引，不会出现在
KEY_COLUMN_USAGE的CONSTRAINT_NAME中（除非显式用CONSTRAINT uk_xxx UNIQUE建表） - 推荐统一按“唯一索引”方式检查，兼容
CREATE TABLE ... UNIQUE KEY和ALTER TABLE ... ADD UNIQUE - 列顺序敏感：
(a,b)和(b,a)是不同索引，校验时需归一化（如按字母序排序后比对）
四、对比声明 vs 实际，并抛出结构不一致异常
对每个实体表：
- 将注解中声明的每组列名排序（如
{"role_code","user_id"}→["role_code","user_id"]） - 将数据库查出的每条索引列组合也排序后匹配
- 若声明了但库中缺失 → 报错：“表 user_role 缺失联合唯一约束 [user_id, role_code]”
- 若库中存在但未在注解声明 → 可选警告（避免误删，生产建议严格匹配）
异常应中断启动（如抛 ApplicationContextException），确保问题暴露在部署早期。
不复杂但容易忽略：校验必须在 DataSource 初始化之后、JPA EntityManagerFactory 构建之前执行，否则可能连不上库；同时要避开 Flyway/Liquibase 等迁移工具正在执行的窗口期——建议监听 DataSourceInitializedEvent 或使用 SpringApplicationRunListener。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
