pg_dump/psql报"FATAL:未在启动包中指定PostgreSQL用户名"错误的原因？

可能的原因及对应解决办法 #

• 客户端版本/PATH冲突：Mac系统可能自带旧版PostgreSQL客户端，或多版本客户端存在PATH优先级问题，导致实际执行的pg_dump/psql并非你预期的v13/v16版本，引发参数解析异常。
  验证方式：执行 which pg_dump 和 pg_dump --version 确认实际调用的二进制路径与版本。
  解决：调整系统PATH，让目标版本的PostgreSQL bin目录优先级最高；或直接使用绝对路径执行命令（例如 /Library/PostgreSQL/16/bin/pg_dump）。

• 客户端二进制损坏：若版本确认无误，可能是客户端安装文件损坏，引发内存分配错误（malloc报错）。
  解决：重新安装对应版本客户端——brew安装的话执行 brew reinstall postgresql@13 或 brew reinstall postgresql@16；官方安装包则卸载后重新下载安装。

• 环境变量干扰：异常的PostgreSQL环境变量（如PGUSER被设为空或无效值）可能覆盖命令行参数。
  验证：执行 echo $PGUSER 查看变量值。
  解决：若变量异常，执行 unset PGUSER 后重试命令。

• 安全软件/网络拦截：Mac上的防火墙、VPN或代理工具可能拦截篡改连接数据包，导致用户名参数未正常传递到服务器。
  解决：暂时关闭这类软件后重试命令，排查是否是拦截导致的问题。

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