Spring Boot启动失败：entityManagerFactory创建及PostgreSQL连接问题

核心问题定位 #

当前启动失败的直接原因是PostgreSQL用户'postgres'认证失败（SQLState:28P01），这是JDBC连接无法建立的根本原因。你之前添加的hibernate.boot.allow_jdbc_metadata_access:false配置，主要作用是禁止Hibernate读取JDBC元数据，本身不会直接导致数据库认证失败，但可能在认证失败的情况下，让Hibernate初始化时更早触发连接校验，从而表现出和之前NPE问题的关联。

分步解决方案 #

1. 优先解决数据库认证问题 #

这是当前启动失败的核心，按以下步骤排查：

• 确认application.yml中的数据库用户名、密码是否正确，特别是postgres用户的密码是否和数据库实例配置一致：

  spring:
    datasource:
      username: postgres
      password: 你的实际密码
      url: jdbc:postgresql://localhost:5432/你的数据库名
  

• 检查PostgreSQL服务是否正常运行，默认端口5432是否开放，目标数据库实例是否存在。
• 用psql客户端直接验证postgres用户权限：执行psql -U postgres -d 你的数据库名，输入密码测试能否成功登录，排除数据库端的权限配置问题。

2. 验证hibernate.boot.allow_jdbc_metadata_access配置的影响 #

之前添加该配置是为了解决NPE，现在可以临时注释掉该配置，重新启动项目：

• 如果注释后NPE重现，说明NPE的根源是Hibernate读取JDBC元数据时的问题，需要结合实体类和数据库表结构排查：
  • 检查实体类的@Table、@Column注解名称是否和数据库表/字段完全匹配（注意PostgreSQL默认区分大小写）。
  • 确认目标数据库表是否已创建，或是否开启了Hibernate自动建表配置（spring.jpa.hibernate.ddl-auto）。
• 如果注释后NPE不重现，且数据库认证问题解决后项目能正常启动，说明之前的NPE是临时场景导致，该配置可以移除。

3. 辅助排查：检查依赖与配置完整性 #

• 确认pom.xml中PostgreSQL驱动和Spring Data JPA的依赖版本兼容：

  <dependency>
      <groupId>org.postgresql</groupId>
      <artifactId>postgresql</artifactId>
      <scope>runtime</scope>
  </dependency>
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
  </dependency>
  

• 检查application.yml中JPA基础配置是否完整：

  spring:
    jpa:
      hibernate:
        ddl-auto: update # 可根据需求改为create、none等
      show-sql: true
      properties:
        hibernate:
          dialect: org.hibernate.dialect.PostgreSQLDialect
  

总结 #

当前的BeanCreationException是数据库认证失败导致的，和hibernate.boot.allow_jdbc_metadata_access配置的关联在于：该配置改变了Hibernate初始化流程，让认证失败的问题更早暴露。优先解决数据库用户名/密码匹配问题，再回头验证NPE的根源即可。

内容的提问来源于stack exchange，提问作者Алишер Ондрис