PostgreSQL运行数月后突发角色不存在错误：应用连失败psql正常

我来帮你拆解这两个实际运维中遇到的PostgreSQL角色报错问题，都是挺常见的坑，咱们一步步来解决：

问题1：首次连接PostgreSQL触发 FATAL: role "*" does not exist #

这个错误逻辑很直接——你应用配置里指定的数据库角色（也就是用户名），在当前PostgreSQL实例里根本没创建出来。这里的*应该是你实际配置里填的角色名，只是被打码了。

解决步骤： #

• 先确认应用配置文件里的数据库用户名到底是什么（比如假设是my_app_user）
• 用PostgreSQL的超级权限角色（比如默认的postgres）登录数据库，创建对应角色并授权：

-- 创建可登录的角色
CREATE ROLE my_app_user WITH LOGIN PASSWORD 'your_secure_password';
-- 给该角色授予目标数据库的操作权限
GRANT ALL PRIVILEGES ON DATABASE your_target_db TO my_app_user;

• 如果是Docker部署的PostgreSQL，可以直接进入容器执行命令：

docker exec -it your_postgres_container_name psql -U postgres
# 进入psql交互界面后执行上面的CREATE ROLE命令

问题2：运行数月后应用连接报错，但psql连接正常 #

这个情况就有点迷惑了——明明用psql能正常连user角色，为啥Hikari连接池触发FATAL: role "user" does not exist？我帮你梳理几个最可能的原因和排查方向：

可能的原因&解决方法： #

• 应用连接配置和psql不一致：
  你用psql的命令是docker exec -it postgresql psql -U user db，但要仔细核对应用的Hikari配置（比如Spring Boot的application.properties/application.yml）里的username字段是不是真的设为user，有没有拼写错误、或者用了未正确赋值的环境变量。
  另外要注意JDBC URL里的隐藏参数——如果URL里写了jdbc:postgresql://host:5432/db?user=wrong_user，这个参数会直接覆盖配置文件里的用户名，一定要检查！

• 连接池缓存了错误配置：
  HikariCP会缓存数据库连接，如果之前的配置有过变更（比如临时改了用户名又改回来），可能连接池里的旧连接还在尝试用错误的角色。这种情况直接重启应用就能解决，要是不想重启，也可以用Spring Boot Actuator的/actuator/hikari端点手动刷新连接池。

• 角色的大小写陷阱：
  PostgreSQL里如果创建角色时加了双引号（比如CREATE ROLE "User" WITH LOGIN;），角色名是严格区分大小写的。要是应用里写的是小写user，就会找不到角色。你可以用psql登录后执行\du命令，查看角色列表里的user是不是大小写和应用配置一致。

• 检查角色的LOGIN权限：
  虽然你用psql能连，但还是确认下user角色有没有LOGIN权限——执行\du后，看角色列表里的user那一行有没有Login标记，要是没有的话执行ALTER ROLE user WITH LOGIN;补上权限。

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