Liquibase变更日志参数报错：ERROR: syntax error at or near "$"求助

嘿，我之前也碰到过一模一样的问题，咱们一步步拆解解决它。

首先得明确问题根源：你写的${db_name}参数没有被Liquibase正确替换，直接原封不动传到了PostgreSQL数据库里。而PostgreSQL根本不认识这种${}格式的变量，自然就抛出语法错误了。

下面给你几个优先级从高到低的解决办法，挨个试试：

1. 确保变更日志的XML结构正确 #

如果你的SQL是写在XML格式的changelog里，一定要把SQL代码放在<changeSet>下的<sql>标签里——这是Liquibase识别并处理参数的前提。正确的结构应该是这样的：

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
                   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                   xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                   http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.9.xsd">

    <changeSet id="create-tenant-access-role" author="your-name">
        <sql>
            DROP ROLE IF EXISTS tenant_access;
            CREATE ROLE tenant_access NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE NOREPLICATION;
            GRANT ALL ON DATABASE ${db_name} TO tenant_access;
        </sql>
    </changeSet>

</databaseChangeLog>

别直接把SQL裸写在XML里，必须套对标签，不然Liquibase只会把它当成普通文本传给数据库，根本不会处理参数替换。

2. 验证liquibase.properties配置是否生效 #

有时候properties文件可能没被正确加载，你可以试试在执行命令时直接传递参数，覆盖properties里的配置，看看能不能成功：

mvn liquibase:update -Dliquibase.parameter.db_name=postgres

如果这样能正常执行，那说明你的properties文件可能路径不对，或者配置项拼写有误——再检查一遍parameter.db_name=postgres这个配置，确保没有打错字。

3. 在变更日志里显式定义属性 #

如果上面的方法还是不行，你可以在XML changelog的开头显式定义属性，把外部传递的参数映射进来，相当于给Liquibase明确标记：“这个${db_name}是要替换的参数”：

<databaseChangeLog ...>
    <!-- 显式引入外部传递的参数 -->
    <property name="db_name" value="${db_name}" />

    <changeSet id="create-tenant-access-role" author="your-name">
        <sql>
            DROP ROLE IF EXISTS tenant_access;
            CREATE ROLE tenant_access NOSUPERUSER INHERIT NOCREATEDB NOCREATEROLE NOREPLICATION;
            GRANT ALL ON DATABASE ${db_name} TO tenant_access;
        </sql>
    </changeSet>
</databaseChangeLog>

这种方式能避免一些参数解析优先级的问题，让Liquibase更明确地处理变量替换。

4. 调整PostgreSQL JDBC URL配置 #

极少数情况下，PostgreSQL的JDBC驱动会干扰Liquibase的参数替换，你可以试试在JDBC URL里加上?escapeSyntaxCallMode=callIfNoReturn，这个参数会让PostgreSQL忽略对${}的解析，完全交给Liquibase处理：

url=jdbc:postgresql://localhost:5432/postgres?escapeSyntaxCallMode=callIfNoReturn

按上面的步骤试一遍，应该就能解决这个报错了。

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