PostgreSQL连接失败的三个高频原因是：host写成localhost导致走Unix socket而非TCP、pg_hba.conf未配置host类型认证规则、用户缺少LOGIN权限；需分别建多个数据源支持多库，且JDBC URL须手动添加connect_timeout和socket_timeout参数。
能直接配，不用装插件，但必须填对 host、端口、用户权限和 JDBC 驱动路径；多数据库不是靠“一个连接开多个库”，而是建多个独立数据源，每个对应一个 dbname。
PostgreSQL 连接失败的三个高频原因
90% 的连接失败不是因为 PhpStorm 不支持，而是参数或权限没对上：
-
host写成localhost→ 改用127.0.0.1，否则 PostgreSQL 可能走 Unix socket，而 PhpStorm JDBC 只走 TCP -
pg_hba.conf没配host类型规则 → 确保有类似host all all 127.0.0.1/32 md5的行，且重载配置（pg_ctl reload或SELECT pg_reload_conf();） - 用户没
LOGIN权限 → 执行ALTER USER your_user WITH LOGIN;，否则即使密码对也拒绝连接
多数据库支持：不是“连一次选多个库”，而是建多个数据源
PhpStorm 不支持单个数据源切换 dbname（不像 psql 的 \c otherdb）。要操作多个库，就得分别创建数据源：
- 每个数据源的
Database字段填唯一库名，比如app_production、app_test - 所有数据源可用同一
User，只要该用户在各库中都有访问权限（CONNECT+USAGEon schema） - 连接后右键某个数据源 →
Properties→Schemas标签页可勾选要内省的 schema，避免加载无关元数据拖慢 IDE
JDBC 驱动和超时参数必须手动加到 URL 里
PhpStorm 默认生成的 JDBC URL 不带超时，一旦网络卡顿或查询 hang 住，整个 Database 工具窗口会无响应。必须手动补全：
立即学习“PHP免费学习笔记（深入）”；
- 在数据源配置的
URL字段末尾追加：?connect_timeout=3&socket_timeout=30 -
connect_timeout=3→ 连不上 3 秒就报Connection to 127.0.0.1:5432 refused，不卡界面 -
socket_timeout=30→ 查询执行超 30 秒自动中断（注意：大事务COMMIT不受此控） - 别写
socketTimeout（那是 MySQL 的），PostgreSQL JDBC 只认下划线命名：socket_timeout
PHP 代码里用 pg_connect() 和 PhpStorm 连接是两套体系
PhpStorm 的 Database 工具走 JDBC，PHP 脚本走 libpq（pg_connect()）或 PDO，两者互不影响。但共用一套认证逻辑：
- 如果
pg_connect("host=127.0.0.1 dbname=test user=dev password=xxx")在 PHP 里能通，那 PhpStorm 用同样参数大概率也能通 - 反之，如果 PhpStorm 连得上，但 PHP 报
pg_connect(): Unable to connect...，优先查 PHP 是否启用了pgsql扩展（php -m | grep pgsql） - 不要把 PhpStorm 里测试成功的连接字符串直接复制进 PHP —— 它含 JDBC 特有参数（如
sslmode=require），PHP 会忽略甚至报错
真正容易被忽略的是：每次新增数据源后，必须点右上角 Test Connection，不能只靠保存。因为 pg_hba.conf 规则、用户权限、防火墙状态都可能随时间变化，IDE 不会自动重检。
