Docker命名卷未持久化数据求助：Laravel+PostgreSQL环境

一、PostgreSQL数据未持久化的核心原因 #

官方postgres镜像默认将数据存储在容器内的/var/lib/postgresql/data路径，你配置的卷挂载路径/path/where/I/want/db/data并非PostgreSQL实际写入数据的目录，导致数据根本没写入命名卷data，关闭容器后自然丢失。

修复方法 #

修改db服务的卷挂载路径为官方默认数据目录：

db:
  image: postgres:latest
  restart: unless-stopped
  volumes:
    - data:/var/lib/postgresql/data  # 替换为PostgreSQL官方默认数据目录
  environment:
    POSTGRES_USER: user
    POSTGRES_DB: db
    POSTGRES_PASSWORD: "password"
  networks:
    - backroom

二、Laravel存储命名卷未生效的原因 #

你的app服务同时配置了绑定挂载../:/app和命名卷storage:/path/to/laravel/base/storage，Docker中绑定挂载的优先级高于命名卷，容器内的/path/to/laravel/base/storage会被本地../storage目录（若存在）直接覆盖，命名卷完全无法发挥作用。

修复方法 #

若要让命名卷接管Laravel的storage目录，需调整挂载策略：

1. 确保命名卷挂载路径是容器内Laravel实际的storage目录（通常为/app/storage，需根据你的镜像构建情况确认）
2. 避免绑定挂载覆盖该目录，可将绑定挂载设为只读（或调整绑定范围）

修改后的app服务配置示例：

app:
  build:
    context: .
  entrypoint: php artisan octane:frankenphp
  ports:
    - "80:8000"
    - "443:443"
    - "443:443/udp" # HTTP/3
    - "5173:5173"
  depends_on:
    - db
    - cache
  volumes:
    - storage:/app/storage  # 匹配容器内Laravel实际的storage路径
    - ../:/app:ro  # 设为只读绑定挂载，避免覆盖容器内storage（按需调整）
  networks:
    - storefront
    - backroom

三、验证命名卷数据的方法 #

Docker命名卷默认存储在宿主机的/var/lib/docker/volumes/目录下，可通过以下命令验证：

• 列出所有命名卷：docker volume ls
• 查看指定卷的详细信息：docker volume inspect <卷名>
• 查看卷内数据（需root权限）：sudo ls /var/lib/docker/volumes/<卷名>/_data

额外注意事项 #

• 修改卷配置后，若之前已启动过容器，需先删除旧卷（docker volume rm <卷名>）再重新启动，否则旧卷的无效数据结构会保留。
• 确保Laravel容器内storage目录权限正确，可在Dockerfile中添加RUN chown -R www-data:www-data /app/storage（根据镜像运行用户调整）

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