Docker部署PostgreSQL初始化后数据不持久化，DBeaver无法查看

• 确认DBeaver连接的目标数据库
  打开DBeaver的连接配置界面，检查「数据库」字段是否明确填写了test_database——很多时候连接会默认使用postgres库，即使日志显示连接到目标库，也可能是配置遗漏。

• 直接进入容器验证数据库实际状态
  执行命令docker exec -it <容器ID或名称> psql -U <你的数据库用户名> test_database进入容器内的PostgreSQL命令行：

  • 输入\l查看所有数据库，确认test_database是否存在；
  • 输入\dt或\dt <你的模式名>.*查看表结构，输入SELECT * FROM <表名> LIMIT 1;验证数据是否存在。
    这一步能直接区分是数据库实际未创建/无数据，还是DBeaver显示问题。

• 检查初始化脚本的执行逻辑与权限

  • Postgres容器会按文件名排序执行/docker-entrypoint-initdb.d/下的脚本，确保创建数据库的脚本（如01_create_db.sql）排在插入数据的脚本之前；
  • 检查脚本中CREATE DATABASE语句是否指定了正确的所有者，比如CREATE DATABASE test_database OWNER <你的用户名>;——若所有者不是连接用户，可能导致无权限查看；
  • 查看容器日志中脚本执行的详细输出，是否有隐性报错（比如语法错误、权限不足），有时候表面显示执行成功，实际存在异常。

• 检查Docker卷挂载配置

  • 确认docker-compose中是否正确挂载了Postgres数据卷（默认路径/var/lib/postgresql/data），如果未挂载该目录，容器重启后数据会丢失；
  • 检查初始化脚本的挂载路径是否正确（如./init-scripts:/docker-entrypoint-initdb.d），确保脚本确实被容器读取执行。

• 排查DBeaver的显示过滤与缓存

  • 右键点击DBeaver中的连接，选择「属性」→「过滤器」，确认是否误将test_database或目标模式加入了排除列表；
  • 右键连接选择「刷新」（或按F5），清除DBeaver的本地缓存，刷新后再查看数据库列表。

• 验证数据库用户权限
  进入容器的psql命令行，执行以下命令确保连接用户拥有足够权限：

  GRANT CONNECT ON DATABASE test_database TO <你的用户名>;
  GRANT USAGE ON SCHEMA <你的模式名> TO <你的用户名>;
  GRANT SELECT ON ALL TABLES IN SCHEMA <你的模式名> TO <你的用户名>;
  

• 检查docker-compose的环境变量
  确认docker-compose中POSTGRES_DB环境变量是否设置为test_database——若该变量未指定，Postgres默认会创建postgres库，你脚本创建的test_database是额外库，连接时必须手动指定目标库名。

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