Docker卷映射异常：Liquibase容器挂载本地文件夹无文件

以下是针对你遇到的问题的具体排查步骤和解决方案：

常见错误点与排查方法 #

1. 卷映射路径问题 #

• 检查本地路径是否正确：Docker Compose中的相对路径是相对于docker-compose.yml文件所在的目录。比如你写./local-changelogs:/mynewchangelog，要确保compose文件所在文件夹下确实存在local-changelogs目录，且里面有文件。如果不确定，直接用绝对路径（如Linux的/home/yourname/changelogs，Windows的/c/Users/yourname/changelogs）测试。
• 验证容器内路径：确认卷映射的目标路径是容器内的/mynewchangelog，而非其子目录（比如不要写成/mynewchangelog/，虽然多数情况不影响，但避免不必要的问题）。

2. 文件权限问题 #

• Linux/macOS环境：本地文件夹的权限可能导致容器无法读取。执行chmod -R 755 ./your-local-folder赋予基本读写权限，或者检查容器运行的用户ID：

  # 查看容器运行的UID
  docker exec <liquibase-container-name> id -u
  # 给本地文件夹设置匹配的UID
  sudo chown -R <container-uid>:<container-gid> ./your-local-folder
  

• Windows环境：打开Docker Desktop设置，进入Resources > File Sharing，确认你要挂载的驱动器（如C盘）已被勾选并保存设置。

3. Docker Compose配置语法错误 #

YAML对缩进和格式敏感，检查你的配置是否符合规范：

• 确保volumes字段在services.liquibase下缩进正确（用空格，不要用Tab）
• 卷映射格式正确，示例：

  services:
    liquibase:
      image: liquibase/liquibase
      volumes:
        - ./changelogs:/mynewchangelog  # 本地路径:容器内路径
      # 其他配置...
  

4. 容器命令或启动问题 #

• 检查容器日志，看是否有覆盖/清空/mynewchangelog的操作：

  docker logs <liquibase-container-name>
  

• 手动测试挂载，排除Compose配置问题：

  # 停止现有容器
  docker-compose stop liquibase
  # 手动启动容器并查看挂载目录内容
  docker run -v ./your-local-folder:/mynewchangelog liquibase/liquibase ls /mynewchangelog
  

  如果这个命令能看到文件，说明你的Compose配置存在语法或逻辑错误；如果还是为空，回到路径/权限排查。

正确配置示例 #

version: '3.8'
services:
  liquibase:
    image: liquibase/liquibase
    volumes:
      # 本地changelog目录映射到容器内的/mynewchangelog
      - ./local-changelogs:/mynewchangelog
    # 执行update命令，指定容器内的changelog文件路径
    command: --changeLogFile=/mynewchangelog/db.changelog.xml update
    environment:
      - LIQUIBASE_URL=jdbc:postgresql://db:5432/mydb
      - LIQUIBASE_USERNAME=postgres
      - LIQUIBASE_PASSWORD=postgres
  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=mydb

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