使用kubectl+pg_dump下载PostgreSQL备份到本地得到空白文件如何解决

核心问题排查 #

你遇到的空文件问题由以下几个错误配置导致：

• kubectl exec添加了-t（分配伪终端）参数，非交互式执行命令时会导致输出流异常，备份内容无法正常回传到本地
• sh -c后的pg_dump命令没有用引号完整包裹，参数会被本地shell提前解析拆分，同时重定向符>的位置错误：如果写在sh -c的命令内部，备份文件会生成在容器内部而不是本地设备
• 环境变量传递逻辑错误：如果没有特殊处理，本地的$DATABASE_PASSWORD等变量不会自动传入容器内部，pg_dump因为缺少认证参数执行失败，但你没有开启错误捕获所以看不到报错
• 缺少执行结果校验逻辑，命令失败也无法感知

修正后的脚本 #

#!/bin/bash -eux
set -o pipefail
namespace="staging"
current_date=$(date +%d_%b_%Y)
file_name="${namespace}_${current_date}.dump"

# 切换集群上下文
kubectl config use-context <context_name> -n $namespace

# 稳定获取Pod名称，避免grep+awk的兼容问题
pod_name=$(kubectl get pods -n ${namespace} -l app=backend -o jsonpath='{.items[0].metadata.name}')
if [ -z "$pod_name" ]; then
  echo "未找到匹配的backend Pod"
  exit 1
fi

# 执行备份逻辑
## 如果你要使用本地环境的数据库变量，用双引号包裹sh -c的命令
kubectl exec -i $pod_name --container <cname> -n $namespace -- sh -c "PGPASSWORD='$DATABASE_PASSWORD' pg_dump --no-owner -x -Fc $DATABASE_NAME -h $DATABASE_HOST -U $DATABASE_USERNAME" > "$file_name"

## 如果你要直接使用容器内部定义的数据库环境变量（推荐，更安全），改用单引号包裹命令
# kubectl exec -i $pod_name --container <cname> -n $namespace -- sh -c 'PGPASSWORD=$DATABASE_PASSWORD pg_dump --no-owner -x -Fc $DATABASE_NAME -h $DATABASE_HOST -U $DATABASE_USERNAME' > "$file_name"

# 校验备份结果
if [ -s "$file_name" ]; then
  echo "备份成功，文件大小: $(du -h $file_name | awk '{print $1}')"
else
  echo "备份失败，生成文件为空"
  rm -f "$file_name"
  exit 1
fi

修改说明 #

1. 开头添加set -eux -o pipefail，脚本执行遇到错误直接退出，同时打印执行日志方便排查问题
2. 移除kubectl exec的-t参数，仅保留-i保证输出流正常回传
3. 调整重定向符位置到kubectl命令外侧，直接将容器内pg_dump的标准输出写入本地文件
4. 增加Pod存在性检查、备份文件有效性检查，快速定位执行失败原因
5. 支持两种环境变量传递方式，适配不同的变量存储场景

内容的提问来源于stack exchange，提问作者opensource-developer