使用Liquibase对比MySQL环境报错：setColumnRemarks不被MySQL支持

嘿，这个问题我之前踩过好几次坑，咱们一步步来搞定它！

你遇到的报错核心原因很明确：MySQL的JDBC驱动默认不支持setColumnRemarks这个操作，但你用liquibase diff对比环境时，自动生成的变更集里包含了修改列注释的语句，执行时自然就触发了异常——那些带1524893614482-984这类编号的变更集，就是生成的注释修改条目。

下面给你三个实用的解决方案，按需选择：

方案一：让Liquibase diff时直接忽略注释（最省心） #

如果你的业务不需要同步数据库列注释，直接在Liquibase配置里跳过注释对比就行：

• 编辑liquibase.properties配置文件，添加：

  diffExcludeObjects=remarks
  

• 或者执行diff命令时直接带参数：

  liquibase diff --diff-exclude-objects=remarks
  

  重新生成变更集后，就不会再出现setColumnRemarks相关的代码了。

方案二：手动修改已生成的变更集 #

要是你不想重新diff，直接打开报错的db/changelog/V1.1.0_prod_uat.xml文件，找到对应的变更集节点，删除里面的setColumnRemarks代码块就行。比如类似这样的内容：

<changeSet id="1524893614482-984" author="davy (generated)">
    <setColumnRemarks tableName="your_table" columnName="your_column" remarks="your_comment"/>
</changeSet>

把这段删掉或者注释掉，再重新执行变更就没问题了。

方案三：配置JDBC驱动支持注释操作（需注意版本兼容性） #

如果你确实需要同步列注释，可以修改MySQL的JDBC连接URL，添加两个参数：

jdbc:mysql://your_host:3306/your_db?useUnicode=true&characterEncoding=utf8&useInformationSchema=true&remarks=true

⚠️ 注意：这个方法在MySQL 8.0及以后的版本可能存在兼容性问题，而且要确保你的JDBC驱动版本足够新，否则可能还是会报错。

额外小提醒 #

团队协作的话，建议把忽略注释的配置加到项目共享的Liquibase配置里，避免其他同事再踩同样的坑；另外尽量保持开发和生产环境的Liquibase、JDBC驱动版本一致，减少版本差异带来的奇怪问题。

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