已解决：Driver class ‘net.sourceforge.jtds.jdbc.Driver’ could not be found, make sure the ‘MS SQL Server

已解决：Driver class ‘net.sourceforge.jtds.jdbc.Driver’ could not be found, make sure the ‘MS SQL Server’ driver (jar file) is installed.

写在前面

在 Java 项目中，使用 jTDS 驱动程序连接 MS SQL Server 时，如果未正确添加 JDBC 驱动程序的 JAR 文件，可能会出现类似于“Driver class ‘net.sourceforge.jtds.jdbc.Driver’ could not be found, make sure the ‘MS SQL Server’ driver (jar file) is installed”的错误提示。此错误提示表明项目中缺少驱动程序文件或驱动程序的路径未被正确配置。

问题描述

报错代码行：

Driver class ‘net.sourceforge.jtds.jdbc.Driver’ could not be found, make sure the ‘MS SQL Server’ driver (jar file) is installed.

报错原因分析：

1. 驱动程序缺失：Java 项目中缺少 jTDS 驱动程序的 JAR 文件，因此无法找到 net.sourceforge.jtds.jdbc.Driver 类。
2. 类路径未配置：即使 JAR 文件已添加，可能类路径（classpath）未被正确配置，导致 JVM 无法加载该驱动程序类。
3. 驱动版本不兼容：项目中使用的驱动版本可能与当前 Java 版本或 MS SQL Server 版本不兼容。
4. 依赖未导入：如果是 Maven 或 Gradle 项目，可能是项目中的 pom.xml 或 build.gradle 文件未正确导入相应的依赖。

解决思路

1. 下载并添加 jTDS 驱动程序：确保项目中已下载并添加正确版本的 jTDS 驱动程序 JAR 文件。
2. 检查类路径配置：确保驱动程序 JAR 文件已添加到类路径，尤其是在 IDE 中（如 Eclipse、IntelliJ IDEA）。
3. 检查项目依赖配置：如果使用 Maven 或 Gradle 构建工具，检查 pom.xml 或 build.gradle 文件是否正确配置了依赖。
4. 考虑升级驱动程序：若 jTDS 驱动版本较老，考虑升级到支持最新 Java 和 MS SQL Server 的版本，或使用 Microsoft JDBC Driver 替代 jTDS。

解决办法

1. 下载并添加 jTDS 驱动程序

如果项目中缺少 jTDS 驱动，可以从以下网站下载合适的 JAR 文件：

• jTDS 1.3.1 下载地址：https://sourceforge.net/projects/jtds/files/jtds/

下载完成后，将 JAR 文件添加到项目的类路径。以下是几种不同类型项目的操作方式：

对于普通 Java 项目：

• 右键点击项目 → Properties → Java Build Path → Libraries → Add External JARs，然后选择下载好的 jtds.jar 文件。

对于 Maven 项目：

如果你使用的是 Maven 项目，可以通过在 pom.xml 文件中添加依赖来自动下载 JAR 文件：

<dependency>
    <groupId>net.sourceforge.jtds</groupId>
    <artifactId>jtds</artifactId>
    <version>1.3.1</version>
</dependency>

然后在项目根目录运行：

mvn clean install

对于 Gradle 项目：

对于使用 Gradle 的项目，可以在 build.gradle 文件中添加如下依赖：

implementation 'net.sourceforge.jtds:jtds:1.3.1'

保存文件后，运行 gradle build 来确保依赖正确导入。

2. 检查类路径（classpath）配置

在 IDE（如 Eclipse、IntelliJ IDEA）中，确保 JAR 文件已被正确添加到类路径：

1. 右键点击项目 → Properties → Java Build Path → Libraries。
2. 如果没有看到 jtds.jar，请手动添加。
3. 对于命令行项目，确保启动时通过 -cp 参数指定了正确的 JAR 文件路径：

java -cp ".;path/to/jtds.jar" YourMainClass

3. 验证驱动是否可以加载

在项目代码中，可以通过以下简单的 Java 代码验证驱动是否加载成功：

try {
    Class.forName("net.sourceforge.jtds.jdbc.Driver");
    System.out.println("Driver loaded successfully.");
} catch (ClassNotFoundException e) {
    System.out.println("Driver not found.");
}

运行这段代码，确认驱动程序是否正确加载。如果输出 “Driver loaded successfully.”，则表示驱动程序已正确添加。

4. 使用 Microsoft JDBC Driver 替代 jTDS

jTDS 驱动较为老旧，且官方已停止维护，建议在某些情况下使用 Microsoft JDBC Driver 来替代 jTDS。Microsoft 官方驱动程序可以通过 Maven 或 Gradle 配置导入：

Maven 配置：

<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>9.4.1.jre8</version>
</dependency>

Gradle 配置：

implementation 'com.microsoft.sqlserver:mssql-jdbc:9.4.1.jre8'

5. 检查 MS SQL Server 连接字符串

在使用 jTDS 驱动时，确保连接字符串正确。典型的连接字符串如下：

String url = "jdbc:jtds:sqlserver://hostname:1433/databaseName;user=username;password=password;";

若你使用的是 Microsoft JDBC Driver，连接字符串则类似于：

String url = "jdbc:sqlserver://hostname:1433;databaseName=yourDatabase;user=yourUsername;password=yourPassword;";

6. 升级或替换驱动程序

如前所述，jTDS 驱动在一些现代系统上可能表现不佳，且不再维护。因此，建议将其替换为 Microsoft JDBC Driver，尤其是在高版本的 Java 和 MS SQL Server 中。

总结

当遇到 “Driver class ‘net.sourceforge.jtds.jdbc.Driver’ could not be found” 错误时，主要原因是 jTDS 驱动未正确添加到项目中。通过下载并添加驱动程序，检查类路径配置，或者使用 Microsoft JDBC Driver 替代 jTDS，可以解决此类问题。