Liquibase连接MS SQL Server 2014失败求助

我之前帮朋友排查过类似的Liquibase连SQL Server的问题，既然你已经用JDBC示例代码成功连上了，那基础的连接参数（URL、账号、密码）肯定是没问题的，问题大概率出在Liquibase的配置或者环境加载上，给你几个排查方向：

1. 先检查Liquibase配置文件的正确性 #

不管你用的是liquibase.properties还是其他配置文件，重点核对这几个关键项：

• driver: com.microsoft.sqlserver.jdbc.SQLServerDriver：确保驱动类名拼写完全正确
• url: jdbc:sqlserver://<你的服务器地址>:<端口>;databaseName=<数据库名>;encrypt=false：注意SQL Server 2014默认不需要加密，加上encrypt=false可以避免SSL相关的问题；如果是本地服务器，地址可以用localhost或者127.0.0.1
• username: <你的用户名>
• password: <你的密码>：如果密码里有@、&这类特殊字符，记得用双引号包裹，比如password: "my&complexpass"
• classpath: <你的mssql-jdbc-6.2.2.jre8.jar的完整路径>：路径里如果有空格，必须用双引号括起来，比如classpath: "C:\\Program Files\\libs\\mssql-jdbc-6.2.2.jre8.jar"

2. 确认JDBC驱动jar被Liquibase正确加载 #

很多时候问题出在这里：你JDBC测试时把jar加到了项目里，但Liquibase运行时没找到这个jar。可以试试两种方式：

• 在命令行显式指定classpath：执行update命令时加上--classpath参数，比如Windows下：

  liquibase --classpath="C:\\path\\to\\mssql-jdbc-6.2.2.jre8.jar" update
  

• 检查Liquibase批处理文件：如果用的是liquibase.bat（Windows）或liquibase.sh（Linux），打开文件看看里面的classpath配置，确保已经包含了mssql-jdbc的jar路径，或者把jar放到Liquibase安装目录的lib文件夹下，这样Liquibase会自动加载。

3. 用命令行直接指定所有参数，排除配置文件问题 #

有时候配置文件可能有格式错误（比如空格、换行问题），可以跳过配置文件，直接在命令行里输入所有参数测试：
Windows下：

liquibase --driver=com.microsoft.sqlserver.jdbc.SQLServerDriver ^
--url=jdbc:sqlserver://localhost:1433;databaseName=YourDB;encrypt=false ^
--username=YourUser ^
--password=YourPass ^
--classpath="C:\\libs\\mssql-jdbc-6.2.2.jre8.jar" ^
update

Linux/macOS下：

liquibase --driver=com.microsoft.sqlserver.jdbc.SQLServerDriver \
--url=jdbc:sqlserver://localhost:1433;databaseName=YourDB;encrypt=false \
--username=YourUser \
--password=YourPass \
--classpath="/path/to/mssql-jdbc-6.2.2.jre8.jar" \
update

如果这样能成功，那就是你的配置文件有问题，回去检查配置文件的格式。

4. 查看详细日志定位具体错误 #

Liquibase默认的错误提示比较笼统，加上--logLevel=debug参数可以看到更详细的报错信息，比如是找不到驱动类，还是连接时的权限问题：

liquibase --logLevel=debug update

根据日志里的具体异常信息（比如ClassNotFoundException说明驱动没加载，SQLServerException说明连接时的数据库层面问题），再针对性解决。

5. 确认Liquibase与JDBC驱动的版本兼容性 #

你用的mssql-jdbc-6.2.2.jre8.jar是兼容SQL Server 2014的，但如果你的Liquibase版本太老（比如3.0以下），可能会有兼容性问题。建议升级到Liquibase 4.x的稳定版本（比如4.20.x），新版本对各种数据库的支持更好。

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