---
title: 数据库备租户 Failover 后序列重复值问题分析与解决-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于 数据库备租户 Failover 后序列重复值问题分析与解决相关的常见问题和使用技巧，帮助您快速解决 数据库备租户 Failover 后序列重复值问题分析与解决的难题。
---
切换语言

- 简体中文
- English

划线反馈

# 数据库备租户 Failover 后序列重复值问题分析与解决

更新时间：2026-05-09 08:26

适用版本： V4.2.x、V4.3.x 内容类型：Troubleshoot  

## 问题现象

在进行数据库灾备切换演练后，应用在插入数据时遇到主键冲突错误，具体表现为序列生成的值出现了重复。问题 SQL 示例如下：

```shell
INSERT INTO test_xxxxxxxxx(serial_no,trade_date,occur_date,occur_time,busi_subject,user_id,op_xxxxxx_no,op_station,op_entrust_way,op_remark,client_id,xxx_xxxx,xxxacct_limit,xxxacct_status,xxxacct_type,main_flag,open_date,close_date,sys_type,sysnode_id,sysnode_id_dest,xxx_pwd,xxxxxx_no,xxxacct_group,xxxacct_class,en_func,en_entrust_way)
SELECT concat(:jyrq, lpad(seq_nextval('seq_xxxxxxxxx_serial_no'),12,'0')),
:jyrq,
date_format(now(),'%Y%m%d'),
curtime(),
:ywbz,
:userid,
:yyb,
:czzd,
:wtfs,
:zy,
client_id,
xxx_xxxx,
xxxacct_limit,
xxxacct_status,
xxxacct_type,
main_flag,
open_date,
close_date,
sys_type,
sysnode_id,
sysnode_id_dest,
xxx_pwd,
xxxxxx_no,
xxxacct_group,
xxxacct_class,
en_func,
en_entrust_way
from test_xxxxxxxxx
where client_id=:khh and xxx_xxxx=:xxxxx;

```

## 关键诊断信息

### 触发条件

1. 假设目前 A 为主租户，B 为备租户，sequence 定义中使用了 cache，本地会有一段 sequence 缓存。
 2. 主备库切换之后，B 为主租户，A 为备租户，这时执行 sequence 的 DDL 操作，有少量 DDL 操作（比如 restart、将 cache 模式改为 nocache 等）需要清除本地 sequence 缓存，而 A 作为备租户没有进行这个操作。
 3. 再次进行主备切换，A 切为主租户，B 切为备租户，这时 A 就会使用本地过期的 sequence 缓存。

### 事前巡检

- 检查序列定义，特别是是否使用了 cache 选项。
 - 审核主备切换的流程和配置，确保序列值能够正确同步。

### 事后诊断

- 查阅备租户的 OBServer 日志和 RS 日志，寻找序列值重复的记录。
 - 分析日志中关于 Failover 操作的时间线，确定序列值重复的具体时间点。

## 问题原因

OceanBase 数据库内核存在一个 BUG，该 BUG 导致在主备切换（Failover）后，主租户清除 sequence 缓存的动作未能正确同步到备租户，从而在主库恢复后继续使用旧的 sequence 缓存，造成序列值重复。

## 问题的风险及影响

- 数据插入时可能遇到主键冲突错误，导致数据完整性受损。
 - 应用程序可能因此中断或产生异常，影响业务连续性和用户体验。

## 影响租户

影响 OceanBase 数据库中的 SYS 租户和 Oracle 租户以及 MySQL 租户。

## 影响版本

OceanBase 数据库企业版 V4.2.1 GA（oceanbase-4.2.1.0-100000182023092722）及之后版本、V4.2.5 GA（oceanbase-4.2.5.0-100000082024102022）及之后版本、V4.3.5 GA（oceanbase-4.3.5.0-100000122024123020）及之后版本。

## 解决方法

- 升级至问题已修复版本。目前已修复的版本包括 OceanBase 数据库企业版 V4.2.5 BP4（oceanbase-4.2.5.4-104000082025052817）及之后版本、V4.3.5 BP4（oceanbase-4.3.5.4-104000052025090918）及之后版本。
 - 在 sequence cache 中记录一个 `epoch_version` 字段，使之与 `switchover_epoch` 对应，在发现缓存 `epoch_version` 过期后主动清除本地缓存。

## 规避方式

- 在序列定义中避免使用 cache 选项，虽然这可能会降低性能，但可以减少主备切换时序列值不一致的风险。
 - 在进行主备切换前，确保所有涉及序列的操作已经完成，避免在切换过程中进行 sequence 的 DDL 操作。
 - 如果已经出现了本问题，可以再次执行 sequence DDL 操作来主动清除缓存。

Previous

[在 OceanBase 数据库 V3.x 版本中进行主备切换时报错 ERROR 4179 (HY000): pre-check failed, switchover to standby not allowed 的原因和解决方法](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002397946)

Next

[MySQL 模式下用户被锁，错误代码 ERROR 3118](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000217856) ![有帮助](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) 咨询热线