go 调用 pg_dump 备份 postgresql 需通过 os/exec.command 启动,用 pgpassword 环境变量传密、显式指定连接参数、选 --format=custom 格式,捕获 stderr 判断具体错误,并确保目标路径存在且权限合理。

怎么用 Go 调用 pg_dump 备份 PostgreSQL
Go 本身不内置数据库导出逻辑,得靠调用系统命令。核心就是用 os/exec.Command 启动 pg_dump,传对参数、处理好环境和权限。
常见错误是直接拼接字符串构造命令,导致密码泄露(出现在 ps aux 里)或特殊字符(如密码含空格、$、@)引发解析失败。
- 必须通过
PGPASSWORD环境变量传密码,而不是-W或--password参数(后者会阻塞等待输入) - 连接参数优先用
--host、--port、--username、--dbname显式指定,别依赖.pgpass文件(部署时易失效) - 输出格式选
--format=custom(-F c)更稳妥:压缩、支持并行恢复、能跨小版本还原;避免用纯 SQL 格式(-F p)处理大库时 OOM 或编码问题
pg_dump 命令参数怎么配才不出错
参数顺序和组合影响很大,尤其涉及 schema 过滤、数据排除、并发控制时。
-
--clean和--if-exists要一起用,否则还原时遇到已存在对象会报错退出 - 只导结构不导数据:加
--schema-only;只导数据不导建表语句:加--data-only—— 但注意--data-only默认仍包含SET和RESET语句,可能干扰目标库配置 - 限制导出大小或行数?
pg_dump不支持。想做子集备份,得先用pg_dump -t指定单表,或用--exclude-table-data排除大表,再单独处理 - 并发导出多个 schema?
pg_dump本身不支持多线程 dump 单库,但可以起多个Command实例分别 dump 不同--schema,前提是它们之间无外键依赖
Go 里怎么捕获 pg_dump 的真实错误
cmd.Run() 返回的 error 只告诉你进程退出非 0,但具体是连接拒绝、权限不足、还是磁盘满,得看 stderr 输出。
立即学习“go语言免费学习笔记(深入)”;
- 务必用
cmd.Stderr = &stderrBuf捕获标准错误,不能只依赖err != nil - 典型错误信息如:
pg_dump: error: connection to database "xxx" failed: FATAL: password authentication failed for user "yyy",或pg_dump: error: query failed: ERROR: permission denied for table zzz - 不要忽略
cmd.Wait()后的exit status 1类提示 —— 有些错误(如部分表不可读)会让pg_dump继续执行但最终返回非零码 - 临时文件路径要显式设
--file,别依赖 stdout 重定向:Go 中管道缓冲区小,大库容易卡死或丢数据
备份文件权限和路径在 Linux 部署时容易被忽略
本地开发跑通了,一上生产就失败,八成是路径或权限问题。
-
pg_dump进程由 Go 应用启动,所以它写入备份文件的用户 = 运行 Go 二进制的用户(比如www-data或postgres),不是你 ssh 登录的用户 - 目标目录必须存在且可写,
pg_dump不会自动创建父级目录 —— Go 侧需提前os.MkdirAll - 备份文件默认无执行权限,但若误设了
0755,某些安全策略会拦截;建议固定用0600(仅属主读写) - PostgreSQL 服务端若开启
password_encryption = scram-sha-256,而客户端pg_dump版本太老(authentication failed —— 查pg_dump --version和服务器SELECT version();是否匹配
最麻烦的其实是时间点一致性:如果备份过程中有 DDL(比如删表),pg_dump 可能中途失败,但它不会自动回滚已写入的部分文件。得靠外部机制校验文件完整性(比如写完立刻 pg_restore -l 测试列表)或加锁协调业务写入窗口。










