Docker中恢复PostgreSQL的.sql.xz备份后数据库仍为空的问题求助

我来帮你排查一下这个问题，这种“恢复命令看似执行完成但数据库为空”的情况通常是几个常见原因导致的，咱们一步步来定位解决：

1. 先确认目标数据库matrix是否存在 #

你恢复命令里指定了要恢复到matrix数据库，但PostgreSQL官方镜像默认只会创建一个名为postgres的数据库。如果matrix不存在，恢复过程其实会静默失败（或者只输出警告），最终数据库自然是空的。

检查方法：

# 进入容器的psql终端
docker exec -it test-postgres psql -U postgres

在psql提示符下输入\l，查看所有数据库列表。如果看不到matrix，先创建它：

docker exec -i test-postgres createdb -U postgres matrix

之后再重新执行你的恢复命令试试。

2. 查看恢复命令的完整错误输出 #

你说“命令看似执行完成”，但可能有错误信息被你忽略了——默认情况下，错误输出是到stderr的，如果你没特意捕获，可能看不到。重新执行恢复命令并捕获所有输出：

xz -dc matrix-ww.sql.xz | docker exec -i test-postgres psql -U postgres matrix --set ON_ERROR_STOP=on --single-transaction 2>&1

这样就能看到所有的日志，比如SQL语法错误、权限问题，或者备份文件本身的问题，这些都会导致恢复失败但表面上看起来“执行完成”。

3. 检查容器启动命令是否正确 #

你最初启动容器的命令docker run --name test-postgres是不完整的！PostgreSQL官方镜像要求必须设置POSTGRES_PASSWORD环境变量，否则容器可能无法正常初始化PostgreSQL实例，甚至启动后立刻退出。

正确的容器启动命令应该是这样的：

docker run -d --name test-postgres -e POSTGRES_PASSWORD=your_secure_password postgres

如果之前的容器因为参数不全没正确初始化，建议先清理旧容器再重新创建：

# 停止并删除旧容器
docker stop test-postgres && docker rm test-postgres
# 用正确参数启动新容器
docker run -d --name test-postgres -e POSTGRES_PASSWORD=your_secure_password postgres
# 先创建matrix数据库
docker exec -i test-postgres createdb -U postgres matrix
# 再执行恢复命令
xz -dc matrix-ww.sql.xz | docker exec -i test-postgres psql -U postgres matrix --set ON_ERROR_STOP=on --single-transaction

4. 验证备份压缩包是否完整 #

有时候备份文件损坏也会导致恢复后无数据。先解压看看SQL文件的内容：

# 解压到本地文件
xz -dc matrix-ww.sql.xz > matrix-ww.sql
# 查看文件开头的内容，确认有建表/插入语句
cat matrix-ww.sql | head -50

如果文件是空的、乱码，或者开头没有CREATE TABLE之类的语句，说明备份包损坏了，需要重新获取正确的备份文件。

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