Docker Compose中Liquibase update执行失败求助

以下是针对问题的具体排查和解决步骤：

1. 核对Docker Compose挂载路径 #

确保本地src/main/resources/db.changelog目录正确挂载到容器内的/liquibase/db.changelog，示例配置如下：

services:
  liquibase:
    image: liquibase/liquibase:latest
    volumes:
      # 本地目录挂载到容器对应路径，相对路径基于docker-compose执行目录
      - ./src/main/resources/db.changelog:/liquibase/db.changelog
    command: update
    environment:
      LIQUIBASE_URL: jdbc:postgresql://postgres:5432/your_database
      LIQUIBASE_USERNAME: your_user
      LIQUIBASE_PASSWORD: your_password
      # 配置changelog文件路径，基于容器内/liquibase工作目录
      LIQUIBASE_CHANGELOG_FILE: db.changelog/migrations.yml

• 执行docker-compose命令时，必须在项目根目录（即src目录的上级目录）运行，否则相对路径会失效。

2. 验证容器内文件是否存在 #

临时进入容器检查挂载目录的文件：

docker-compose run --rm liquibase ls -la /liquibase/db.changelog

如果看不到migrations.yml和关联SQL文件，说明：

• 本地路径拼写错误（注意Linux容器区分大小写）
• 挂载路径的相对基准目录不正确

3. 确保关联SQL文件也被挂载 #

如果仅单独挂载migrations.yml，会导致文件中引用的SQL文件无法找到，必须挂载整个db.changelog目录，因为Liquibase需要读取目录下的所有关联文件。

4. 检查文件权限（Linux/macOS环境） #

本地目录权限可能导致容器无法读取文件，执行以下命令赋予可读权限：

chmod -R 755 src/main/resources/db.changelog

5. 确认Liquibase的changelog路径配置 #

检查LIQUIBASE_CHANGELOG_FILE环境变量或liquibase.properties中的路径：

• 可以使用相对路径（基于容器内/liquibase工作目录）：db.changelog/migrations.yml
• 也可以使用绝对路径：/liquibase/db.changelog/migrations.yml
  确保两种写法都和挂载路径匹配。

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