---
title: 数据备份报错 -9129 且日志中有 IO 限流报错的诊断方法-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于 数据备份报错 -9129 且日志中有 IO 限流报错的诊断方法相关的常见问题和使用技巧，帮助您快速解决 数据备份报错 -9129 且日志中有 IO 限流报错的诊断方法的难题。
---
切换语言

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

划线反馈

# 数据备份报错 -9129 且日志中有 IO 限流报错的诊断方法

更新时间：2026-05-11 09:51

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

## 问题现象

备份任务失败，`CDB_OB_BACKUP_JOB_HISTORY` 中备份任务报错 `-9129（object storage io error）`。报错日志中有IO限流相关说明：`code=429, exception="RequestRateLimitExceeded", err_msg="Unable to parse ExceptionName: RequestRat eLimitExceeded Message: Your request rate is too high. We have put limits on your bucket."`。

## 关键信息

- 备份任务报错代码：`-9129 (object storage io error)`，搜索日志中有 IO 限流相关说明。

  根据 `CDB_OB_BACKUP_JOB_HISTORY` 中给出任务执行信息，到执行任务失败的节点上搜索任务失败时间附近的 trace_id 日志里对象存储返回的 err_msg。

  ```shell
  grep "[trace_id]" observer.log.xxxxx | grep "err_msg"

  ```

  ![image01](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/backup-and-restore/20251128diagnostic-methods-data-backup-error-9129-with-io-rate-limiting-errors-logs01.png)

  对应上图显示是接近 2025-11-14 17:21:02 时在节点 xxx.xxx.xxx.xxx:2882 上报的错。根据 `trace_id:YBxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx` 执行 `grep "YBxxxxx-xxxxxxxx-xxxxxxxx-xxxxxxxx" observer.log.202511141720* | grep "err_msg"`，可以看到具体的对象存储访问失败的原因为 `code=429, exception="RequestRateLimitExceeded", err_msg="Unable to parse ExceptionName: RequestRat eLimitExceeded Message: Your request rate is too high. We have put limits on your bucket."`。

  ![image02](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/backup-and-restore/20251128diagnostic-methods-data-backup-error-9129-with-io-rate-limiting-errors-logs02.png)
 - 在数据库管理平台的性能监控中观察对应时间段的 IO 备份 IO 写入大小和备份 IO 写入次数。
 - 咨询云服务厂商具体当前 Bucket 的写入带宽和 IO 次数限制，并咨询 Bucket 被 IO 限流的原因。
 - 比对云服务厂商给出限流原因和性能监控中的统计结果，判断是否符合限流预期。

  ![image03](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/backup-and-restore/20251128diagnostic-methods-data-backup-error-9129-with-io-rate-limiting-errors-logs03.png)

## 问题原因

多个节点同时执行备份任务，导致 OBServer 节点写入 Bucket 速率达到 Bucket 的写入带宽上限，触发 IO 限流，造成备份任务失败。

## 问题的风险及影响

对象存储 Bucket IO 限流导致备份任务失败。

## 适用版本

OceanBase 数据库 V4.x 版本。

## 解决方法

1. 与云服务提供商沟通，请求增加 Bucket 的写入带宽上限或 IO 请求次数上限。
 2. 通过执行 `ALTER SYSTEM SET ha_low_thread_score = N tenant = 租户名;`（N 指单节点备份任务并发度）命令适当**调小备份任务的并发度，减少同时写入 Bucket 的数据量**。
 3. 经过上述调整后，重新发起备份任务。

## 规避方式

1. 确保 Bucket 的写入带宽上限能够满足备份需求。
 2. 根据 Bucket 带宽及 IOPS 限制情况设置合理的并发情况（`ALTER SYSTEM SET ha_low_thread_score = N tenant = 租户名;` N 为单节点任务并发度）。

上一篇

[从 OSS 上 copy 备份文件到 NFS 恢复报错 -4055 的原因及解决方法](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002998408)

下一篇

[大规模分区（百万分区）场景下物理恢复时间异常增长问题说明](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000002493944) ![有帮助](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) 咨询热线