Mac OS使用pg_restore恢复PostgreSQL本地数据库备份失败 退出码1无日志

• 优先排查命令的shell路径解析问题
  你当前命令中的pg_restore可执行路径/Volumes/pgAdmin 4/pgAdmin 4.app/Contents/SharedSupport/pg_restore包含带空格的目录名pgAdmin 4，且命令书写时没有给整个执行路径加双引号。macOS默认的shell会把无引号的带空格路径拆分为多个独立参数，导致根本找不到匹配的可执行文件，直接返回退出码1，部分场景下因为路径解析失败，程序和shell的输出会被完全吞掉。
  验证方式：先单独执行带双引号的版本，检查能否正常输出版本信息："/Volumes/pgAdmin 4/pgAdmin 4.app/Contents/SharedSupport/pg_restore" --version，如果这一步就报错，先把所有带空格的路径都套上双引号再重新执行恢复。
• 排查参数冲突问题
  你同时在命令中指定了--create和--dbname "sport_match"参数。pg_restore的--create逻辑为：先连接到PostgreSQL实例的默认维护库（通常为postgres），按照指定的dbname名称创建空数据库，再重新连接到新建库执行后续恢复流程。如果当前本地实例上已经存在同名的sport_match数据库，创建流程会直接中断，配合--no-password的非交互连接模式，具体报错很容易被吞掉。
  另外要注意：--create参数仅支持pg_dump生成的自定义归档格式、tar格式的备份文件，如果你的备份是纯SQL文本格式，使用--create参数也会导致无报错直接退出。
• 校验备份文件的可读性和格式匹配性
  你指定的备份文件路径为/Users/dylan/Downloads/sportmatch_2021，首先要确认当前登录用户对该文件有读权限，且文件没有损坏。
  可以通过两个命令验证：
  • 检查文件格式：file /Users/dylan/Downloads/sportmatch_2021，如果输出显示是纯ASCII文本SQL文件，不能用pg_restore恢复，需要改用psql执行。
  • 尝试解析备份内容：用pg_restore的列表模式读取备份结构，执行"/Volumes/pgAdmin 4/pgAdmin 4.app/Contents/SharedSupport/pg_restore" -l "/Users/dylan/Downloads/sportmatch_2021"，如果这一步无法正常输出备份内的对象列表，说明备份文件损坏或格式不匹配。
• 强制捕获被拦截的执行日志
  你当前的命令没有做错误输出重定向，非交互场景下pg_restore的日志默认输出到标准错误流（stderr），很容易被终端配置拦截导致看不到输出。执行时可以在命令末尾加上2>&1 | tee ~/restore_debug.log，把所有标准输出、标准错误流都同步保存到本地日志文件，哪怕程序执行中断，也能从日志文件中拿到具体报错点。
  调整后的基础命令框架参考：

"/Volumes/pgAdmin 4/pgAdmin 4.app/Contents/SharedSupport/pg_restore" \
--host "127.0.0.1" \
--port "5432" \
--username "postgres" \
--no-password \
--dbname "sport_match" \
--section=pre-data --section=data --section=post-data \
--create --verbose \
"/Users/dylan/Downloads/sportmatch_2021" 2>&1 | tee ~/restore_debug.log

• 验证本地PostgreSQL实例的连通性
  先单独测试本地5432端口的PostgreSQL服务是否可正常连接，执行psql -h 127.0.0.1 -p 5432 -U postgres -d postgres -c "select 1"，如果这一步连接失败，先排查数据库实例是否正常运行、pg_hba.conf的本地连接权限配置、端口是否被其他程序占用的问题，再执行恢复操作。

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