---
title: "事务空闲超时，错误代码 ORA-24761 - OceanBase 数据库 V4.2.1 | OceanBase 文档中心"
description: "事务空闲超时，错误代码 ORA-24761 本文介绍 OceanBase 数据库 Oracle 模式下事务空闲超时后报 ORA-24761 错误的处理方法。 问题现象 开启事务后，等待较长一段时间，执行查询表数据时报错。 obclient [SYS]&gt; SELECT * FROM ordr; +----+------…"
---
切换语言

- 中文站 - 简体中文
- International - English
- 日本站 - 日本語

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*P8CuR4UJ_FkAAAAAAAAAAAAADiGDAQ/original) OceanBase 数据库分布式版 - V 4.2.1 LTS

# 事务空闲超时，错误代码 ORA-24761

更新时间：2026-07-15 22:01:30

[编辑](https://github.com/oceanbase/oceanbase-doc/edit/V4.2.1/zh-CN/300.develop/200.application-development-of-oracle-mode/700.application-error-handling-specification-and-common-error-solutions-of-oracle-mode/200.common-errors-and-solutions-of-oracle-mode/200.transaction-idle-timeout-with-error-code-ora-24761-of-oracle-mode.md)  

本文介绍 OceanBase 数据库 Oracle 模式下事务空闲超时后报 `ORA-24761` 错误的处理方法。

## 问题现象

开启事务后，等待较长一段时间，执行查询表数据时报错。

```sql
obclient [SYS]> SELECT * FROM ordr;
+----+------+-------+------------------------------+
| ID | NAME | VALUE | GMT_CREATE                   |
+----+------+-------+------------------------------+
|  1 | CN   |  NULL | 04-NOV-22 06.06.16.843024 PM |
|  2 | UK   |  NULL | 04-NOV-22 06.06.16.843024 PM |
|  3 | US   |  NULL | 04-NOV-22 06.06.16.843024 PM |
+----+------+-------+------------------------------+
3 rows in set

obclient [SYS]> UPDATE ordr SET value=1003 WHERE id=3;
Query OK, 1 rows affected
Rows matched: 1  Changed: 1  Warnings: 0

/* 等待较长一段时间不操作*/

obclient [SYS]> SELECT * FROM ordr;
ORA-24761: transaction rolled back: transaction idle timeout

```

该报错信息对应的错误码信息如下：

- 错误码：ORA-24761
 - OceanBase 错误码：6211
 - SQLSTATE：25000

关于错误码的详细说明及介绍，请参见 [错误码概述](https://www.oceanbase.com/docs/common-oceanbase-database-cn-1000000000218668)。

## 可能原因

事务空闲超时表示事务内两条语句的执行间隔超过了指定的阈值。当事务空闲时间超过了指定的阈值时，如果继续执行数据库操作，系统就会报错。事务空闲超时由租户变量 `ob_trx_idle_timeout` 控制，默认值为 86400000000 微秒，即 24 小时。

#### 说明

OceanBase 数据库为了避免事务长时间不提交持有锁影响其他会话，设计了两个超时逻辑：事务空闲超时和事务未提交超时。通常只会有一个超时机制会先被触发。

## 解决方法

请参考以下步骤，查看并修改租户变量，再通过 `ROLLBACK` 回滚事务后，继续操作。

1. 查看变量 `ob_trx_idle_timeout` 的值，确认操作的超时时间是否超过了设置的值。

   事务空闲超时时间阈值由租户变量 `ob_trx_idle_timeout` 控制，单位为微秒，建议使用默认值 24 小时（86400000000 微秒）。

#### 说明

以下设置变量的方法仅对当前会话有效，如果需要保证设置永久生效，请使用 `SET GLOBAL` 语法配置相同变量后，再重启会话使其生效。

```sql
obclient [SYS]> SHOW VARIABLES LIKE 'ob_trx_idle_timeout';
+---------------------+-----------+
| VARIABLE_NAME       | VALUE     |
+---------------------+-----------+
| ob_trx_idle_timeout | 120000000 |
+---------------------+-----------+
1 row in set

obclient [SYS]> SET SESSION ob_trx_idle_timeout=86400000000;
Query OK, 0 rows affected

```

2. 使用 `ROLLBACK` 回滚事务。

   ```sql
   obclient [SYS]> ROLLBACK;
   Query OK, 0 rows affected

   ```
 3. 再次查询表数据。

   ```

 上一篇 下一篇 ![有帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*y6ocSqN8cqsAAAAAAAAAAAAAARQnAQ)![无帮助](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*BG9IQJyLHF8AAAAAAAAAAAAAARQnAQ)![反馈](https://gw.alipayobjects.com/mdn/ob_asset/afts/img/A*eTWdQKCRKHwAAAAAAAAAAAAAARQnAQ)[AI](https://www.oceanbase.com/obi) 咨询热线
