Java中无法直接通过自定义@Table注解自动校验MySQL表结构，但可通过自定义注解+启动扫描+JDBC元数据比对+DDL检查实现联合唯一约束声明与结构校验，关键在于分离“声明”和“执行”。
OpenJDK 24
OpenJDK 24 Windows x64 官方参考实现（24+36），适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。
下载
<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>
@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 ""; // 可选：约束名，用于比对和报错定位
}
</pre>
</font>
<p>这样就能在实体类上写：</p>
<font color="gray">
<pre>
@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 { ... }
</pre>
</font>
<H3>二、启动时扫描实体类并提取约束声明</H3>
<p>用 Spring Boot 的 <code>ApplicationContextInitializer</code> 或 <code>@PostConstruct</code>（配合 <code>ApplicationRunner</code>）在容器刷新前扫描所有带 <code>@Table</code> 的实体类：</p>
<ul>
<li>通过 <code>ClassPathScanningCandidateComponentProvider</code> 扫描 <code>@Entity</code> 类</li>
<li>反射获取 <code>@Table</code> 注解，解析出每个 <code>UniqueConstraint</code></li>
<li>构建内存模型：<code>Map<String, List<Set<String>>></code>（表名 → 联合列名集合列表）</li>
</ul>
<H3>三、用 JDBC 查询 MySQL 现有唯一约束（含联合唯一）</H3>
<p>MySQL 中联合唯一索引会记录在 <code>INFORMATION_SCHEMA.STATISTICS</code>，且 <code>NON_UNIQUE = 0</code> 表示唯一索引：</p>
<font color="gray">
<pre>
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;
</pre>
</font>
<p>注意点：</p>
<ul>
<li>MySQL 的联合唯一约束底层是唯一索引，不会出现在 <code>KEY_COLUMN_USAGE</code> 的 <code>CONSTRAINT_NAME</code> 中（除非显式用 <code>CONSTRAINT uk_xxx UNIQUE</code> 建表）</li>
<li>推荐统一按“唯一索引”方式检查，兼容 <code>CREATE TABLE ... UNIQUE KEY</code> 和 <code>ALTER TABLE ... ADD UNIQUE</code></li>
<li>列顺序敏感：<code>(a,b)</code> 和 <code>(b,a)</code> 是不同索引，校验时需归一化（如按字母序排序后比对）</li>
</ul>
<H3>四、对比声明 vs 实际，并抛出结构不一致异常</H3>
<p>对每个实体表：</p>
<ul>
<li>将注解中声明的每组列名排序（如 <code>{"role_code","user_id"}</code> → <code>["role_code","user_id"]</code>）</li>
<li>将数据库查出的每条索引列组合也排序后匹配</li>
<li>若声明了但库中缺失 → 报错：“表 user_role 缺失联合唯一约束 [user_id, role_code]”</li>
<li>若库中存在但未在注解声明 → 可选警告（避免误删，生产建议严格匹配）</li>
</ul>
<p>异常应中断启动（如抛 <code>ApplicationContextException</code>），确保问题暴露在部署早期。</p>
<p>不复杂但容易忽略：校验必须在 DataSource 初始化之后、JPA EntityManagerFactory 构建之前执行，否则可能连不上库；同时要避开 Flyway/Liquibase 等迁移工具正在执行的窗口期——建议监听 <code>DataSourceInitializedEvent</code> 或使用 <code>SpringApplicationRunListener</code>。</p>
