位置：文档库 > 数据库 > Oracle关于java.sql.SQLException常见错误集锦

Oracle关于java.sql.SQLException常见错误集锦

逃跑计划上传于 2020-05-25 14:51

《Oracle关于java.sql.SQLException常见错误集锦》

在Java应用中与Oracle数据库交互时，java.sql.SQLException是开发者最常遇到的异常之一。这类异常可能由网络问题、SQL语法错误、权限不足、资源耗尽等多种原因引发。本文将系统梳理Oracle数据库操作中常见的SQLException类型，分析其成因，并提供针对性的解决方案。

一、连接层常见异常

1.1 连接超时类异常

当应用无法在指定时间内建立与Oracle的连接时，会抛出以下异常：

java.sql.SQLException: Io 异常: The Network Adapter could not establish the connection
// 或
java.sql.SQLException: ORA-12541: TNS:no listener

成因分析：

Oracle监听器未启动（lsnrctl status检查）
防火墙阻止了1521端口通信
连接字符串配置错误（主机名/IP/端口）
网络延迟导致超时

解决方案：

// 检查监听状态
lsnrctl status

// 验证连接字符串格式
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=192.168.1.100)(PORT=1521))
(CONNECT_DATA=(SERVICE_NAME=ORCL)))

1.2 认证失败异常

用户名/密码错误或账户被锁定时会触发：

java.sql.SQLException: ORA-01017: invalid username/password; logon denied
// 或
java.sql.SQLException: ORA-28000: the account is locked

处理步骤：

确认用户名密码大小写（Oracle默认区分大小写）
检查账户状态：

SELECT username, account_status FROM dba_users WHERE username='YOUR_USER';

解锁账户（需DBA权限）：

ALTER USER scott ACCOUNT UNLOCK;

二、SQL执行层异常

2.1 语法错误类

典型的SQL语法错误异常：

java.sql.SQLException: ORA-00904: "INVALID_COLUMN": invalid identifier
// 或
java.sql.SQLException: ORA-00933: SQL command not properly ended

调试建议：

使用SQL Developer等工具先验证SQL语句
检查动态SQL拼接是否正确（警惕字符串拼接导致的语法错误）
启用JDBC日志记录完整SQL：

// 在连接URL中添加
jdbc:oracle:thin:@host:port:SID?logger=Finest

2.2 约束违反异常

主键/唯一键/外键约束冲突：

java.sql.SQLException: ORA-00001: unique constraint (SCOTT.PK_EMP) violated
// 或
java.sql.SQLException: ORA-02292: integrity constraint (SCOTT.FK_DEPT) violated

解决方案：

先查询是否存在冲突数据
考虑使用MERGE语句替代INSERT
事务处理时确保操作顺序正确

// MERGE示例
MERGE INTO emp e
USING (SELECT ? as empno FROM dual) s
ON (e.empno = s.empno)
WHEN NOT MATCHED THEN
  INSERT (empno, ename) VALUES (s.empno, ?);

三、资源管理异常

3.1 连接泄漏

未正确关闭连接导致的异常：

java.sql.SQLException: ORA-01000: maximum open cursors exceeded
// 或
java.sql.SQLException: ORA-24418: Cannot open new sessions

最佳实践：

// 使用try-with-resources确保资源释放
try (Connection conn = dataSource.getConnection();
     PreparedStatement stmt = conn.prepareStatement(sql);
     ResultSet rs = stmt.executeQuery()) {
    // 处理结果集
} // 自动关闭所有资源

3.2 事务超时

长时间运行的事务可能遇到：

java.sql.SQLException: ORA-02049: timeout: distributed transaction waiting for lock

优化策略：

设置合理的事务隔离级别
将大事务拆分为多个小事务
配置事务超时时间：

// JTA事务超时设置
@Transactional(timeout = 30)
public void processData() { ... }

四、高级异常处理

4.1 死锁检测

Oracle死锁会抛出：

java.sql.SQLException: ORA-00060: Deadlock detected while waiting for resource

诊断步骤：

查询死锁信息：

SELECT * FROM v$locked_object;
SELECT * FROM v$session WHERE blocking_session IS NOT NULL;

分析等待链
优化事务设计（避免跨表长事务）

4.2 批量操作异常

批量插入时部分失败的处理：

// 使用BatchUpdateException获取具体失败信息
try {
    conn.setAutoCommit(false);
    for (Data data : dataList) {
        stmt.setString(1, data.getValue());
        stmt.addBatch();
    }
    int[] results = stmt.executeBatch();
    conn.commit();
} catch (BatchUpdateException e) {
    // 获取每个语句的执行结果
    int[] updateCounts = e.getUpdateCounts();
    // 处理部分失败的情况
    conn.rollback();
}

五、性能相关异常

5.1 游标耗尽

当应用打开过多游标时：

java.sql.SQLException: ORA-01000: maximum open cursors exceeded

解决方案：

增加open_cursors参数（需DBA权限）

ALTER SYSTEM SET open_cursors=300 SCOPE=BOTH;

优化代码及时关闭ResultSet
使用连接池配置最大活动连接数

5.2 内存溢出

处理大数据集时的异常：

java.sql.SQLException: ORA-04036: PGA memory used by the instance exceeds PGA_AGGREGATE_TARGET

优化建议：

使用分页查询：

// Oracle分页语法
SELECT * FROM (
    SELECT a.*, ROWNUM rn FROM (SELECT * FROM large_table) a
    WHERE ROWNUM = ?;

调整PGA参数
考虑使用流式处理（如Spring的JdbcTemplate.queryForStream）

六、Oracle特有错误码

表6-1 常见Oracle特有错误码

错误码	含义	解决方案
ORA-00942	表或视图不存在	检查表名大小写和权限
ORA-02289	序列不存在	确认序列名和schema
ORA-06512	PL/SQL堆栈跟踪	查看完整错误链
ORA-01555	快照过旧	增加undo表空间或优化查询

七、异常处理最佳实践

1. 精细化异常捕获：

try {
    // JDBC操作
} catch (SQLIntegrityConstraintViolationException e) {
    // 处理约束冲突
} catch (SQLTransientConnectionException e) {
    // 处理临时连接问题
} catch (SQLException e) {
    // 其他SQL异常
}

2. 日志记录建议：

记录完整的错误堆栈
包含SQL状态码（e.getSQLState()）
记录供应商错误码（e.getErrorCode()）

3. 重试机制实现：

int retries = 3;
while (retries-- > 0) {
    try {
        return jdbcTemplate.execute(connection -> {
            // 数据库操作
        });
    } catch (SQLTransientConnectionException e) {
        if (retries == 0) throw e;
        Thread.sleep(1000 * (3 - retries));
    }
}

关键词：Oracle数据库、java.sql.SQLException、JDBC异常处理、连接超时、约束违反、死锁处理、批量操作异常、资源泄漏、性能优化

简介：本文系统梳理了Java应用中与Oracle数据库交互时常见的java.sql.SQLException类型，涵盖连接层异常、SQL执行错误、资源管理问题、高级异常场景及性能相关错误。通过分析典型错误码和提供代码示例，详细阐述了各类异常的成因、诊断方法和解决方案，同时给出了异常处理的最佳实践建议。

《Oracle关于java.sql.SQLException常见错误集锦.doc》

将本文的Word文档下载到电脑，方便收藏和打印

推荐度：

点击下载文档

立即下载

数据库相关