将PostgreSQL数据库存储至外接HDD时的连接故障排查

提示找不到/tmp/.s.PGSQL.5432文件的本质是PostgreSQL服务未成功启动。该unix domain socket是PG启动完成后才会生成的本地通信文件，文件不存在代表服务进程根本未正常运行，和psql连接命令本身无关。

• 确认外接HDD挂载状态
  • 执行df -h确认外接盘已正常挂载、对应路径可被系统访问，避免系统重启后外接盘未自动挂载，导致PG启动时找不到data_directory指向的路径
  • 排查文件系统兼容性：Mac环境下，NTFS、exFAT格式的外接盘不支持Unix权限位管控，无法满足PostgreSQL对数据目录的强制权限要求，需将盘格式化为APFS（Mac原生支持）或搭载可正常管控权限的驱动的ext4格式，才可作为PG数据存储目录
• 修正数据目录权限
  • PostgreSQL强制要求数据目录权限为700（仅目录所有者具备读写执行权限），且目录所有者为PG进程的实际运行用户（brew安装的Mac端PG默认以当前系统登录用户身份运行）
  • 若文件系统支持Unix权限管控，执行如下命令修正配置：

    sudo chmod 700 /path/to/externalHDD/directory
    sudo chown $USER /path/to/externalHDD/directory
    

• 确认数据目录已完成初始化
  • 若外接盘上的目标路径是全新空目录，未完成数据库初始化流程，PG会直接启动失败
  • 两种处理方案可任选：
    • 将原有/usr/local/var/postgres/路径下的所有文件（包括隐藏配置文件）完整拷贝到外接盘目标路径，避免遗漏文件导致启动失败
    • 在外接盘目标路径执行initdb -D /path/to/externalHDD/directory，完成全新数据库的初始化
• 查启动日志定位精准错误
  • brew安装的PostgreSQL启动日志默认存储在/usr/local/var/log/目录下对应PG版本的日志文件中，打开日志可直接看到启动失败的具体原因（如权限拒绝、路径不存在、磁盘格式不兼容等），无需盲目排查
• 重启服务验证
  • 所有配置调整完成后，重新执行brew services restart postgresql，等待5-10秒确认服务进程正常运行后，再执行psql命令连接

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