Java连接MS SQL Server抛出ClassNotFoundException异常求助
解决java.lang.ClassNotFoundException: com.sqlserver.jdbc.Driver异常
这个问题太常见了,本质就是你的Java项目里没把SQL Server的JDBC驱动包加入到类路径中,JVM找不到com.sqlserver.jdbc.Driver这个类才抛出的错误。下面给你两种靠谱的解决方式,按需选就行:
1. 用构建工具(Maven/Gradle)自动引入依赖
如果你的项目用Maven或Gradle管理,直接加对应依赖就行,不用手动下载jar包:
- Maven:在
pom.xml的<dependencies>标签里添加:<dependency> <groupId>com.microsoft.sqlserver</groupId> <artifactId>mssql-jdbc</artifactId> <version>12.4.1.jre8</version> <!-- 注意:这里版本要匹配你的Java版本,比如Java8用jre8,Java11用jre11,Java17用jre17 --> </dependency> - Gradle:在
build.gradle的dependencies块里添加:implementation 'com.microsoft.sqlserver:mssql-jdbc:12.4.1.jre8'
添加完后刷新构建,工具会自动下载驱动包并加入类路径。
2. 手动添加JDBC驱动jar包
如果不用构建工具,就手动操作:
- 下载对应版本的
mssql-jdbc.jar(要匹配你的Java和SQL Server版本) - 把jar包放到项目的
lib目录里(没有就新建一个) - 在IDE里把它加入类路径:
- Eclipse:右键项目 → Build Path → Add External Archives → 选中下载的jar包
- IDEA:右键jar包 → Add as Library
额外提醒几个容易踩坑的点
- 从SQL Server JDBC驱动6.0版本开始,**不需要写
Class.forName("com.sqlserver.jdbc.Driver")**了,驱动会自动注册到DriverManager,你可以把这行代码删掉,省得麻烦。 - 你的连接URL格式有问题,正确格式应该是
jdbc:sqlserver://<SERVER>:<PORT>;databaseName=<DATABASE_NAME>,比如jdbc:sqlserver://localhost:1433;databaseName=FactBulkSMS,原来的URL缺了//、端口和数据库名,后续可能连不上,记得改。 - 你的ResultSet读取代码也有问题:SQL只查了
MsgTextArabic一列,但你用了rs.getInt(1)+""+rs.getString(2)+""+rs.getString(3),索引2和3会报列不存在的错,改成rs.getString(1)就好。
内容的提问来源于stack exchange,提问作者Mohammad




