JDBC程序的常见错误及调试

本文是《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

解决方案，查看数据库中列的长度。

 

http://blog.youkuaiyun.com/javaeeteacher