Keycloak连接PostgreSQL数据库密码认证失败，求问题排查

核心问题分析 #

你遇到的密码认证失败，主要有两个关键原因：

1. Keycloak数据库连接配置冲突 #

你的Keycloak配置中同时使用了完整的KC_DB_URL和拆分的KC_DB_URL_HOST参数，这会导致JDBC连接配置混乱，甚至优先使用错误的主机地址尝试连接。另外，KC_DB_URL中使用容器名postgresDB虽然在Docker网络中可解析，但改用服务名postgres（即docker-compose中PostgreSQL服务的名称）更稳定可靠。

2. PostgreSQL数据卷已存在，用户密码不匹配 #

PostgreSQL的POSTGRES_USER和POSTGRES_PASSWORD环境变量仅在容器第一次初始化时生效。如果你之前启动过这套docker-compose，pgdata卷已经存储了旧的用户密码，即使现在修改环境变量，PostgreSQL也不会更新已有用户的密码，直接导致认证失败。

分步解决方案 #

第一步：修复Keycloak配置冲突 #

修改docker-compose.yml中Keycloak的环境变量，删除冗余的拆分参数，仅保留完整的JDBC URL（改用服务名postgres）：

keycloak:
  image: quay.io/keycloak/keycloak:23.0.4
  restart: unless-stopped
  command: start-dev
  environment:
    KC_DB: postgres
    KC_DB_URL: jdbc:postgresql://postgres:5432/keycloakdb
    KC_DB_USERNAME: keycloak_demo_user
    KC_DB_PASSWORD: keycloak
    KC_DB_SCHEMA: public
    KEYCLOAK_ADMIN: admin
    KEYCLOAK_ADMIN_PASSWORD: admin
    KC_HOSTNAME: localhost
  # 其余端口、网络、卷配置保持不变

第二步：重置PostgreSQL数据卷（关键操作） #

删除已存在的pgdata卷，让PostgreSQL重新初始化用户和数据库：

# 停止并移除所有容器及关联数据卷
docker-compose down -v
# 重新启动服务
docker-compose up -d

第三步：添加健康检查（可选但推荐） #

为PostgreSQL服务添加健康检查，确保Keycloak只在PostgreSQL完全就绪后启动，避免因服务未就绪导致的连接失败：

修改PostgreSQL服务配置：

postgres:
  container_name: postgresDB
  image: postgres
  environment:
    POSTGRES_DB: keycloakdb
    POSTGRES_USER: keycloak_demo_user
    POSTGRES_PASSWORD: keycloak
  ports:
    - "5432:5432"
  volumes:
    - pgdata:/var/lib/postgresql/data
  networks:
    - custom-keycloak
  healthcheck:
    test: ["CMD-SHELL", "pg_isready -U keycloak_demo_user -d keycloakdb"]
    interval: 5s
    timeout: 5s
    retries: 5

同时修改Keycloak的depends_on配置：

depends_on:
  postgres:
    condition: service_healthy

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