记录一下Java JDBC连接微软SQL Server遇到的那些坑_trustservercertificate=true 无效

最近忙实习，宅在国内远程办公，然后呢我的西班牙老板又要求我用Java做某个管理系统。由于我的电脑和公司的远程电脑上都装的是SQL Server 2019，为了图方便，我就没有换数据库系统软件，顺便随手建了个库建了个表来测试一下。

表大概长这么一个样子：

 插入了一些数据：

用户建好了，也授予了对应权限，于是就开始编写Java代码连接和简单的查询了：

package com.ernesto;
 
import java.sql.*;
 
public class Main {
    public static void main(String[] args) {
        String drvName = "com.microsoft.sqlserver.jdbc.SQLServerDriver";
        String dbURL = "jdbc:sqlserver://localhost:1433;DatabaseName=StudentManagement";
        String userName = "JavaExp";
        String userPwd = "123";
        Connection dbc;
        try {
            Class.forName(drvName); // load microsoft's jdbc driver
            DriverManager.setLoginTimeout(2);
            dbc = DriverManager.getConnection(dbURL, userName, userPwd);
            System.out.println("Connection successfully!");
            Statement stm = dbc.createStatement();
            ResultSet rs = stm.executeQuery("SELECT Sno, Sname FROM t_Student ORDER BY Sno DESC");
            while(rs.next()) {
                System.out.println("Student Number: " + rs.getString("Sno")
                    + "\tStudent Name: " + rs.getString("Sname"));
            }
            stm.close();
            dbc.close(); // Should disconnect
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

顺便提一下，JDBC驱动我用的是微软最新的11.2.1版本，适用于JRE 11的。这个可以直接在项目的build.gradle里面配置，省得去微软官网下载JAR再导入Eclipse，很麻烦。示例：

dependencies {
    implementation 'com.microsoft.sqlserver:mssql-jdbc:11.2.1.jre11'
    // ...
}

但执行的时候，就出大问题了。

首先是连接不上去，这坨西班牙文的大概意思就是说连接超时被拒绝了：

而且里面有个很关键的提示，就是这个数据库连接采用的是TCP/IP协议，然后想了一下1433端口是不是telnet不通，后来一试果然不行。

所以马上就去查SQL Server的配置管理器，依次展开SQLSERVER网络配置-SQLINSTANCE的协议，一看TCP/IP协议确实是被禁用了。既然都禁用了，那还连得上个鬼，于是马上启用：

 然后还要检查是不是开的1433端口，一看居然开的是动态端口，那必须得改！马上改成固定的1433端口：

 最后记得要重启数据库服务器，在SSMS里面直接在服务实例上右键菜单点击重启就好了：

 好，重启了，再连接，接下来又报错，说是SSL证书有问题：

网上搜了一大堆方案，很多人要么说是缺一个安全凭证jssecacerts证书文件需要生成，要么说是要升级sql支持TLS1.2，还有各种打补丁改注册表的。这些我统统都试了，不仅麻烦，还不管用，该出错还是出错。

先前用mysql平台连接的时候，我想起来自己处理这种问题一般就是禁用ssl验证或者信任根证书，那在SQL Server这里管不管用呢？答案是管用的，但是找了半天没有找到怎么配置，后来去微软开发者网站上找到了方案，就是说在URL连接里面加入 ;TrustServerCertificate=True 信任根证书。所以马上把那段代码改了一下：

String dbURL = "jdbc:sqlserver://localhost:1433;DatabaseName=StudentManagement;TrustServerCertificate=True";

再运行，终于可以查出来了：

浪费了一下午的时间，终于搞定了。在此写这篇博文，也是想给后来人提个醒，把这些坑统统避掉。