Hibernate逆向工程报错：读取mysql.user列元数据失败

核心原因 #

这个报错本质是Hibernate逆向工程默认尝试扫描MySQL系统库（如mysql库）中的user表，但当前数据库账号无该系统表访问权限，或是MySQL 8.0+版本的系统表结构变化，导致驱动无法正常读取元数据。

具体解决步骤 #

1. 限制逆向工程仅扫描目标业务库 #

明确指定要生成实体类的业务数据库，避免Hibernate遍历所有数据库：

• 若使用hibernate.reveng.xml配置，添加如下内容：

<hibernate-reverse-engineering>
    <schema-selection match-schema="你的业务库名称"/>
    <!-- 可选：指定具体要逆向的表，进一步缩小范围 -->
    <table-filter match-name="业务表1"/>
    <table-filter match-name="业务表2"/>
</hibernate-reverse-engineering>

• 若在IDE逆向向导中，直接选择你的业务数据库，不要勾选系统库mysql。

2. 修改数据库连接URL参数 #

在hibernate.cfg.xml的连接URL中添加nullCatalogMeansCurrent=true，强制Hibernate仅操作当前指定的业务库：

<property name="hibernate.connection.url">
    jdbc:mysql://localhost:3306/你的业务库名称?useSSL=false&serverTimezone=Asia/Shanghai&nullCatalogMeansCurrent=true
</property>

3. 使用仅拥有业务库权限的账号 #

避免使用root等高权限账号，创建仅能访问业务库的专用账号：

CREATE USER '业务专用账号'@'%' IDENTIFIED BY '账号密码';
GRANT ALL PRIVILEGES ON 你的业务库名称.* TO '业务专用账号'@'%';
FLUSH PRIVILEGES;

用该账号重新连接数据库，从根源避免Hibernate尝试访问无权限的系统表。

4. 适配MySQL 8.0+版本 #

如果使用MySQL 8.0及以上版本：

• 确保mysql-connector-j版本在8.0.23以上，避免驱动与新系统表结构不兼容
• 驱动类指定为com.mysql.cj.jdbc.Driver，而非旧版的com.mysql.jdbc.Driver
• 连接URL必须包含serverTimezone参数（如serverTimezone=Asia/Shanghai）

5. 排除系统表扫描（高权限账号场景） #

若必须保留高权限账号，在hibernate.reveng.xml中直接排除系统表：

<hibernate-reverse-engineering>
    <table-filter exclude="true" match-name="user" match-schema="mysql"/>
    <!-- 可按需添加其他需排除的系统表 -->
    <table-filter exclude="true" match-name="db" match-schema="mysql"/>
</hibernate-reverse-engineering>

内容的提问来源于stack exchange，提问作者Vennuss12