JDBC 程序的常见错误及调试方法

转自：http://www.jb51.net/article/18421.htm

本文是《Java Web开发教程——入门与提高篇（JSP+Servlet）》一书《第9章 JDBC技术》的补充内容。

数据库：MySQL 

在编写应用的时候，为了调试程序方便，可以在异常处理代码中把异常信息显示出来，这样可以根据错误提示调试代码。异常处理代码通常可以写成这样： 
try{ 
… 
}catch(Exception e){ 
System.out.println(e.toString()); 
} 
下面是一些常见的错误信息： 
（1）驱动程序不存在 
提示的错误信息如下： 
java.lang.ClassNotFoundException: com.mysql.jdbc.Drive 
后半部分是您在程序中写的驱动程序的名字。 
解决方法：仔细检查类名是否写错，如果类名没有写错，则是驱动程序所在的压缩包没有引入工程，想办法引入。 
（2）URL写错 
提示的错误信息如下： 
java.sql.SQLException: No suitable driver 
解决方法：仔细检查URL的格式是否正确，不同数据库的URL格式不同。 
（3）主机IP地址不正确或者网络不通 
提示的错误信息如下： 
com.mysql.jdbc.CommunicationsException: Communications link failure due to underlying exception:

** BEGIN NESTED EXCEPTION ** 

java.net.ConnectException 
MESSAGE: Connection timed out: connect 

STACKTRACE: 

java.net.ConnectException: Connection timed out: connect 
at java.net.PlainSocketImpl.socketConnect(Native Method) 
at java.net.PlainSocketImpl.doConnect(Unknown Source) 
at java.net.PlainSocketImpl.connectToAddress(Unknown Source) 
at java.net.PlainSocketImpl.connect(Unknown Source) 
at java.net.SocksSocketImpl.connect(Unknown Source) 
at java.net.Socket.connect(Unknown Source) 
at java.net.Socket.connect(Unknown Source) 
at java.net.Socket.<init>(Unknown Source) 
at java.net.Socket.<init>(Unknown Source) 
at com.mysql.jdbc.StandardSocketFactory.connect(StandardSocketFactory.java:132) 
at com.mysql.jdbc.MysqlIO.<init>(MysqlIO.java:273) 
at com.mysql.jdbc.Connection.createNewIO(Connection.java:1639) 
at com.mysql.jdbc.Connection.<init>(Connection.java:393) 
at com.mysql.jdbc.NonRegisteringDriver.connect(NonRegisteringDriver.java:262) 
at java.sql.DriverManager.getConnection(Unknown Source) 
at java.sql.DriverManager.getConnection(Unknown Source) 
at test.JDBCTest.oracleTest(JDBCTest.java:25) 
at test.JDBCTest.main(JDBCTest.java:12) 
** END NESTED EXCEPTION ** 
解决方法：查看IP地址是否正确，网络是否有问题。 
（4）端口错误或者数据库服务器没有启动 
提示的错误信息如下： 
com.mysql.jdbc.CommunicationsException: Communications link failure due to underlying exception:

** BEGIN NESTED EXCEPTION ** 

java.net.ConnectException 
MESSAGE: Connection refused: connect 

STACKTRACE: 

java.net.ConnectException: Connection refused: connect 
at java.net.PlainSocketImpl.socketConnect(Native Method) 
at java.net.PlainSocketImpl.doConnect(Unknown Source) 
at java.net.PlainSocketImpl.connectToAddress(Unknown Source) 
at java.net.PlainSocketImpl.connect(Unknown Source) 
at java.net.SocksSocketImpl.connect(Unknown Source) 
at java.net.Socket.connect(Unknown Source) 
at java.net.Socket.connect(Unknown Source) 
at java.net.Socket.<init>(Unknown Source) 
at java.net.Socket.<init>(Unknown Source) 
at com.mysql.jdbc.StandardSocketFactory.connect(StandardSocketFactory.java:132) 
at com.mysql.jdbc.MysqlIO.<init>(MysqlIO.java:273) 
at com.mysql.jdbc.Connection.createNewIO(Connection.java:1639) 
at com.mysql.jdbc.Connection.<init>(Connection.java:393) 
at com.mysql.jdbc.NonRegisteringDriver.connect(NonRegisteringDriver.java:262) 
at java.sql.DriverManager.getConnection(Unknown Source) 
at java.sql.DriverManager.getConnection(Unknown Source) 
at test.JDBCTest.oracleTest(JDBCTest.java:25) 
at test.JDBCTest.main(JDBCTest.java:12) 


** END NESTED EXCEPTION ** 
解决方法：查看端口是否正确，数据库服务器是否启动。 
（5）数据库名字不正确 
提示的错误信息如下： 
java.sql.SQLException: Unknown database 'test2' 
解决方法：查看数据库是否存在。 
（6）用户名或者口令不正确 
提示的错误信息如下： 
java.sql.SQLException: Access denied for user 'roo'@'localhost' (using password: YES) 
解决方法：确认用户名和口令是否正确。 
（7）表名错误 
提示的错误信息如下： 
java.sql.SQLException: Table 'test.student1' doesn't exist 
解决方法：查看表是否存在，表名是否写错。 
（8）列名错误 
提示的错误信息如下： 
java.sql.SQLException: Unknown column 'sid' in 'field list' 
解决方案：仔细查看数据库表中的列名。 
（9）处理结果集的时候，要获取的列的序号大于列数，或者小于0 
提示的错误信息如下： 
java.sql.SQLException: Column Index out of range, 4 > 3. 
这个错误产生的背景是：数据库表中只有3列，而在取信息的时候使用了rs.getString(4)，尤其是在使用循环处理的时候容易犯这样的错误。 
（10）执行insert语句的时候，表中的列数与插入语句中的不相同 
提示的错误信息如下： 
java.sql.SQLException: Column count doesn't match value count at row 1 
该错误产生的背景是：数据库表中有3列，而插入的时候给了4个值，SQL语句如下： 
insert into student values('0011323','李旭',22,99)。 
（11）执行insert语句的时候，主键重复。 
提示的错误信息如下： 
java.sql.SQLException: Duplicate entry '0011323' for key 1 
该错误产生的背景是：1条SQL语句连续执行了两遍，第二遍就出错了。 
（12）执行insert语句的时候，值过长 
提示的错误信息如下： 
java.sql.SQLException: Data too long for column 'id' at row 1 
解决方案，查看数据库中列的长度。