---
title: OCP Docker 根目录空间不足导致集群升级失败的原因和解决方法-OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于OCP Docker 根目录空间不足导致集群升级失败的原因和解决方法相关的常见问题和使用技巧，帮助您快速解决OCP Docker 根目录空间不足导致集群升级失败的原因和解决方法的难题。
---
切换语言

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

划线反馈

# OCP Docker 根目录空间不足导致集群升级失败的原因和解决方法

更新时间：2026-07-02 15:41

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

## 问题现象

通过 OCP V4.3.5 升级 OceanBase 数据库集群报错信息如下。

```shell
com.oceanbase.ocp.core.exception.UnexpectedException: [OCP UnexpectedException]: status=500 INTERNAL_SERVER_ERROR, errorCode=AGENT_TASK_FAILED, args=02a85cdd-b768-475c-92ba-d1441b668e8c,OcpAgentError: code = 2000, message = Cannot download file from url: http://172.x.x.x:8010/api/v2/object-storage/sys-package/oceanbase-4.xxx.el7.x86_64.rpm, reason: failed to download file from url, cannot save response: unexpected EOF

```

![image01](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/cluster-management/20250728insufficient-space-in-ocp-docker-root-directory-causes-cluster-upgrade-failure01.png)

## 关键诊断信息

查看 OCP Docker 挂载目录，可知磁盘空间不足。

```shell
# docker info --format '{{.DockerRootDir}}'
/docker
# df -hT /docker/
Filesystem           Type  Size  Used Avail Use% Mounted on
/dev/mapper/vga-root xfs   120G  120G  282M 100% /

```

清理空间后重试任务，成功完成。

## 问题原因

根据 `unexpected EOF` 报错，首先排查文件是否上传正确（如通过 OAT 查看 OCP 是高可用部署架构，可以在所有服务器上检查）。

```shell
[root@ocp ~]# docker exec -it ocp bash
[root@ocp admin]# ls -lth data/files/sys-package/
total 979M
-rw-r--r-- 1 admin admin   40 6月  19 14:31 oceanbase-4.xxx.el7.x86_64.rpm.sha1sum
-rw-r--r-- 1 admin admin 482M 6月  19 14:31 oceanbase-4.xxx.el7.x86_64.rpm
[root@ocp admin]# md5sum data/files/sys-package/oceanbase-4.xxx.el7.x86_64.rpm
963b2a62b996103c2fc27385c91eceaf  data/files/sys-package/oceanbase-4.xxx.el7.x86_64.rpm

```

对比原始文件，可以看到文件 md5 没有问题。

```shell
% md5 oceanbase-4.xxx.el7.x86_64.rpm
MD5 (oceanbase-4.xxx.el7.x86_64.rpm) = 963b2a62b996103c2fc27385c91eceaf

```

手动在 OCP 本机下载文件，可以看到报错 `No space left on device`。

```shell
# wget http://172.x.x.x:8010/api/v2/object-storage/sys-package/oceanbase-4.xxx.el7.x86_64.rpm
Connecting to 172.x.x.x:8010... connected.
HTTP request sent, awaiting response... 200
Length: 504737724 (481M) [application/octet-stream]
Saving to: ‘oceanbase-4.xxx.el7.x86_64.rpm’

oceanbase-4.xxx.el7.x86_64.rpm                                         58%[=======================================================================================================================================>                                                                                                 ] 281.41M   252MB/s    in 1.1s

Cannot write to ‘oceanbase-4.xxx.el7.x86_64.rpm’ (No space left on device).

```

## 问题的风险及影响

OCP Docker 挂载目录磁盘空间不足不仅影响集群升级，也影响上传软件包等功能。 如因磁盘空间不足影响上传软件包时，可以查看 OCP 日志。

```shell
docker exec -it ocp bash
tail -f /home/admin/logs/ocp/ocp.log

```

可以看到相关报错如下：

```shell
Caused by: org.apache.tomcat.util.http.fileupload.impl.IOFileUploadException: Processing of multipart/form-data request failed. No space left on device
...
java.io.IOException: No space left on device
..

```

## 适用版本

OceanBase 数据库 V3.x、V4.x 版本。

## 解决方法

清理 Docker 根据目录空间后重试任务。

## 规避方式

建议通过 LVM 划分磁盘并分配磁盘给 `/docker` 目录，以在空间不足时灵活分配磁盘空间，详情可参见：[OceanBase 数据库安装部署之磁盘初始化](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000003564245?back=kb)。 如使用 OAT 部署，建议统一通过 OAT 完成磁盘初始化操作，包括 Docker 根目录（`/docker`），如下图所示。

![image02](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/database/cluster-management/20250728insufficient-space-in-ocp-docker-root-directory-causes-cluster-upgrade-failure02.png)

上一篇

[升级 OBServer 时预检查报错 tenant unit not exist but partition exist](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000003226868)

下一篇

[创建租户失败后，执行升级脚本 upgrade_checker.py 报错 compatible is not sync 的原因和解决方法](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000001940147) ![有帮助](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) 咨询热线