Windows下使用Liquibase Docker传入自定义配置与changelog及路径报错解决

• 你所有报错中提到的文件路径指向Git安装目录下的子文件夹，核心原因是Git Bash终端的MSYS路径自动转换机制：当你在Git Bash中输入以/开头的路径时，终端会自动将其映射到Git的安装根目录，不会将原始路径原样传递给Docker或容器内的Liquibase进程。
• 之前执行命令时，你传入的/liquibase/xxx格式的路径参数，全部被Git Bash转成了本地Git目录下的Windows路径，和容器内的实际文件路径完全不匹配，因此反复报文件找不到的错误。
• 你之前尝试挂载-v /c/PROJECTS/DOCKER:/liquibase/changelog时仍然报错，也是因为路径转换机制篡改了挂载参数的容器侧路径，导致卷没有正确挂载到容器内的/liquibase/changelog目录。
• 额外的路径错位问题：你之前传入的--defaultsFile=liquibase.properties是相对路径，Liquibase在容器内会基于默认工作目录/liquibase解析该路径，而你的配置文件是存放在本地通过卷挂载的目录中，没有映射到容器的默认工作目录下，自然也无法被找到。
• 即使你手动传入了所有数据库连接参数，只要文件路径被终端篡改导致changelog或配置文件无法被找到，还是会报完全相同的FileNotFoundException，和数据库参数是否正确无关。
• 本地直接运行Liquibase时可以正常访问文件，是因为本地Liquibase进程直接运行在Windows系统上，无需路径转换即可读取本地磁盘文件；而Docker中的Liquibase运行在隔离的Linux容器环境中，无法直接访问Windows本地磁盘，必须通过卷挂载的方式将本地目录映射到容器内后，才能读取对应文件。

1. 关闭Git Bash的路径自动转换 #

• 在所有docker run命令前添加MSYS_NO_PATHCONV=1环境变量，直接禁用Git Bash的路径自动篡改逻辑，保证所有Linux格式的容器路径能被原样传递。
• 如果你使用PowerShell或CMD终端执行命令，无需添加该环境变量，因为这两类终端不存在上述路径转换机制。

2. 正确配置本地文件的卷挂载 #

• 直接将你存放changelog.sql和liquibase.properties的本地目录（即C:\Test\liquibase），通过卷挂载映射到容器内的任意路径，示例中我们选择映射到容器内的/liquibase/changelog路径（也可以自定义其他容器内路径，不强制使用镜像默认路径）。
• 挂载的写法规则为：-v 本地Windows目录路径:容器内映射的路径，针对你的场景挂载部分即为-v C:\Test\liquibase:/liquibase/changelog。
• 挂载完成后，你本地C:\Test\liquibase下的所有文件，都可以通过容器内/liquibase/changelog/路径直接访问。

3. 修正Liquibase的参数路径 #

• 所有传给Liquibase的配置文件、changelog文件路径，必须使用容器内的绝对Linux路径，不能写相对路径，也不能写Windows本地路径：
  • 配置文件路径写为：--defaultsFile=/liquibase/changelog/liquibase.properties
  • changelog文件路径写为：--changeLogFile=/liquibase/changelog/changelog.sql

4. 完整可运行的命令示例 #

以你之前要执行的changelogSyncSQL命令为例，修正后的完整命令为：

MSYS_NO_PATHCONV=1 docker run --rm \
  -v C:\Test\liquibase:/liquibase/changelog \
  liquibase/liquibase \
  --defaultsFile=/liquibase/changelog/liquibase.properties \
  --changeLogFile=/liquibase/changelog/changelog.sql \
  --url=jdbc:postgresql://你的数据库地址:5432/你的库名 \
  --username=你的数据库账号 \
  --password=你的数据库密码 \
  changelogSyncSQL

• 如果你想自定义容器内的挂载路径（比如不想用默认的/liquibase/changelog），只需要保证挂载时的容器内路径和传给Liquibase的参数路径完全一致即可，比如将本地目录挂载到容器内/custom/liquibase/files，则参数里的文件路径全部写为/custom/liquibase/files/xxx就可以正常运行。
• 不要尝试将Windows格式的本地路径（如C:\Test\liquibase\changelog.sql）直接传给容器内的Liquibase，因为Liquibase运行在Linux环境的容器中，无法识别Windows格式的本地路径。
• 如果你需要执行generateChangeLog等需要生成输出文件的命令，记得将输出路径也指向容器内的挂载目录，否则生成的文件会存在容器内部，容器删除后就会丢失。

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