Liquibase变更日志属性替换失败：GitHub Actions部署报错排查

你的问题不是SQL语法错误，核心原因是Liquibase的变量替换未生效，导致${MY_ENV}这个原始字符串直接被发送给数据库执行，数据库无法识别$开头的语法，因此抛出了语法错误。

解决步骤： #

1. 确保Liquibase命令正确接收变量 #

在GitHub Actions的Liquibase执行命令中，必须显式将环境变量传递给Liquibase，使用-D参数传递外部属性是标准方式：

# 若变量存在于GitHub Secrets中
liquibase update -DMY_ENV=${{ secrets.MY_ENV }}

# 若变量是GitHub Actions环境变量
liquibase update -DMY_ENV=$MY_ENV

只有通过这种方式传递的变量，Liquibase才会在解析SQL文件时替换掉${MY_ENV}占位符。

2. 检查属性替换是否被禁用 #

默认情况下Liquibase的属性替换是开启的，但如果你的liquibase.properties或命令行参数中存在property.substitution.enabled=false，会直接禁用替换功能。检查相关配置，确保该参数为true（或不配置，默认即为true）。

3. 验证变量是否正确传递 #

可以在GitHub Actions步骤中先打印变量，确认MY_ENV有值：

echo "MY_ENV value: $MY_ENV"

如果变量为空或未传递到Liquibase进程，替换后会变成空字符串，同样可能导致SQL执行错误。

4. 完整GitHub Actions示例 #

steps:
  - name: 拉取代码
    uses: actions/checkout@v4

  - name: 执行Liquibase部署
    uses: liquibase/liquibase-action@v4
    with:
      command: update
      args: -DMY_ENV=${{ secrets.DB_USER_PASSWORD }}
      changelog-file: path-to-sql/changelog.json

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