Hibernate启动报错HHH000262：表未找到，开发环境迁移后求助

根据你遇到的情况——刚迁移到性能更高的本地电脑，PostgreSQL 9.6搭配Hibernate 5.0.7.Final，相同配置在另外两台机器运行完全正常，唯独新环境启动时每张表都触发HHH000262: Table not found的错误，我整理了几个最可能的排查方向和解决办法，你可以逐一尝试：

1. 检查数据库连接URL的Schema指定 #

PostgreSQL默认用public schema，但如果你的表不在这个schema下，或者新环境的连接URL没明确指定schema，Hibernate就可能找不到表。

• 看看你的连接URL有没有加currentSchema参数，比如：

  jdbc:postgresql://localhost:5432/your_db?currentSchema=your_schema_name
  

• 哪怕表确实在public schema，也可以显式加上currentSchema=public，避免因环境默认配置差异踩坑。

2. 验证表名的大小写匹配问题 #

PostgreSQL对表名的大小写很敏感：如果建表时用了引号（比如"UserTable"），表名会保留大小写；没加引号的话，PostgreSQL会自动转成小写。而Hibernate默认会严格按照实体类@Table注解里的名称去查找，很容易出现不匹配：

• 先核对实体类的@Table注解和数据库里的表名，比如数据库表是小写的usertable，实体类里就得写@Table(name="usertable")；
• 也可以给Hibernate加个配置，让它自动把表名转成小写：在hibernate.cfg.xml或者Spring配置里加这两行：

  hibernate.implicit_naming_strategy=org.hibernate.boot.model.naming.ImplicitNamingStrategyLegacyJpaImpl
  hibernate.physical_naming_strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl
  

3. 确认数据库用户的访问权限 #

新环境的数据库用户可能没拿到足够的权限访问目标表，导致Hibernate检测不到表的存在：

• 登录PostgreSQL，执行下面的命令给用户赋权（替换成你的用户名和schema）：

  GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA your_schema TO your_user;
  GRANT ALL PRIVILEGES ON ALL SEQUENCES IN SCHEMA your_schema TO your_user;
  

• 也可以先执行\dt命令，用当前连接用户看看能不能看到目标表，确认权限没问题。

4. 检查Hibernate的方言配置 #

Hibernate 5.0.7对PostgreSQL 9.6的方言得配置正确，错的方言会导致元数据读取异常：

• 确认你的Hibernate配置里方言是这个：

  hibernate.dialect=org.hibernate.dialect.PostgreSQL95Dialect
  

  虽然你的PostgreSQL是9.6，但Hibernate 5.0.7里最高的PostgreSQL方言就是PostgreSQL95Dialect，它完全兼容9.6版本。

5. 验证hbm2ddl.auto的配置 #

如果你的hbm2ddl.auto设成了validate，Hibernate会严格检查数据库里的表是否存在。要是新环境的数据库还没创建表（比如你还没跑初始化脚本），就会触发这个错误：

• 可以临时把hbm2ddl.auto改成update，启动应用让Hibernate自动建表，之后再改回validate；
• 或者手动执行数据库初始化脚本，确保所有表都已经创建好。

我建议你先从Schema指定和大小写匹配这两个方向入手，这是跨环境迁移时最容易踩的坑。

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