连接本地Postgres报Too many levels of symbolic links错误如何解决

报错核心原因是/tmp/.s.PGSQL.5432这个PostgreSQL Unix socket文件存在循环软链接，系统无法顺着链接找到实际的socket实体，按以下顺序排查即可，不需要照搬Ubuntu专属方案：

• 第一步先确认文件状态
  执行ls -l /tmp/.s.PGSQL.5432查看文件属性，正常情况下PostgreSQL启动后会在对应位置生成实体socket文件，不会是软链接。如果输出显示该文件是软链接，且链接目标指向自身、或经过多层跳转最终指回自身，就是循环链接问题。

• 修复损坏的socket文件

  1. 先停掉本地运行的PostgreSQL服务，根据你的安装方式选对应命令：
     • macOS Homebrew安装：brew services stop postgresql
     • macOS官方安装包部署：sudo pg_ctl -D /Library/PostgreSQL/<你的数据库版本号>/data stop
     • 非Ubuntu的Linux发行版（CentOS/Arch/Fedora等）：sudo systemctl stop postgresql
  2. 删除损坏的软链接，同目录下的锁文件也一并清理：

     sudo rm -f /tmp/.s.PGSQL.5432
     sudo rm -f /tmp/.s.PGSQL.5432.lock
     

  3. 重新启动PostgreSQL服务，服务会自动在/tmp目录下生成新的实体socket文件，此时再启动Rails Console测试连接即可。

• 如果重启服务后问题复现，检查路径配置不匹配问题
  很多时候出现软链接是因为有人发现PostgreSQL默认生成socket的路径不是/tmp，手动做软链接映射时操作失误搞成了循环，这种情况不需要做软链接，直接对齐两边配置即可：

  1. 找到PostgreSQL配置文件postgresql.conf，搜索unix_socket_directories配置项，确认数据库实际生成socket的目录，常见非/tmp的默认路径有/var/run/postgresql/
  2. 打开Rails项目下的config/database.yml，把数据库连接的host字段改成上面查到的实际socket目录路径，比如host: /var/run/postgresql，保存后重启Rails Console即可正常连接。

• 极端场景排查：/tmp目录异常
  如果上面两个方法都无效，执行mount | grep /tmp检查/tmp目录的挂载状态，如果/tmp本身被配置成软链接、或挂载的文件系统禁止socket文件/软链接正常访问，可以直接修改postgresql.conf里的unix_socket_directories配置到其他有读写权限的目录，同步修改Rails的database.yml对应host配置即可，不需要修复/tmp目录。

快速验证技巧：直接在命令行执行psql -h /tmp，如果该命令也报同样的符号链接错误，说明问题和Rails无关，完全是PostgreSQL服务端或socket文件的问题；如果psql能正常连接，只有Rails报错，直接检查Rails的database.yml配置即可。

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