---
title: "桌面版 ODC 安装问题 - 开发者中心 ODC V4.3.2 | OceanBase 文档中心"
description: 桌面版 ODC 安装问题 如何下载桌面版 ODC 安装包？ 桌面版 ODC 支持 Windows、MacOS 操作系统，用户可以通过以下站点下载 ODC 桌面版安装包。 方法 1：从云数据库 OceanBase 文档页下载 打开 下载桌面版 ODC 页面 ，下载 ODC 对应版本的桌面版 ODC 安装包。 方法 2：…
---
切换语言

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

文档反馈![](https://mdn.alipayobjects.com/huamei_22khvb/afts/img/A*lqS5SYzz_YEAAAAAAAAAAAAADiGDAQ/original) 开发者中心 ODCV 4.3.2

# 桌面版 ODC 安装问题

更新时间：2026-04-13 15:31:21

[编辑](https://github.com/oceanbase/odc-doc/edit/V4.3.2/zh-CN/1300.troubleshooting/400.faq/100.client-odc-installation-faq.md)  

## **如何下载桌面版 ODC 安装包？**

桌面版 ODC 支持 Windows、MacOS 操作系统，用户可以通过以下站点下载 ODC 桌面版安装包。

- 方法 1：从云数据库 OceanBase 文档页下载

  打开[下载桌面版 ODC 页面](https://help.aliyun.com/document_detail/212816.html)，下载 ODC 对应版本的桌面版 ODC 安装包。

  ![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/4.faq/1.client-odc-installation-faq/1.png)
 - 方法 2：从 OceanBase 软件下载中心下载

  打开 [OceanBase 软件下载中心](https://www.oceanbase.com/softwarecenter) 页面，下载 ODC 对应版本的桌面版 ODC 安装包。

  ![2](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/4.faq/1.client-odc-installation-faq/2.png)

  #### 说明

  用户需要拥有 OceanBase 官网账号并开通白名单。

## 桌面版 ODC 安装预检查时会检查哪些项目？

桌面版 ODC 预检查项目如下所示：

- Windows 操作系统版本检查：仅支持 Windows 7 及以上版本。
 - 端口检查：查看 8989 是否被占用。在 ODC V2.3.0 后采用动态端口将不再检查该项。
 - Java 运行环境检查：ODC V4.1.0 之前的版本建议安装 JDK 1.8.0_242 及以上版本；ODC V4.1.0 及之后版本的安装包中已附加 JDK 安装包，无需检查 Java 运行环境。

## **桌面版 ODC 安装或启动失败时如何查看日志？**

### ODC V3.3.0 之后的版本

在日志文件 main.log 中查看报错信息。日志的存放路径如下所示：

- Linux： ~/.config/odc/logs
 - macOS： ~/Library/Application Support/Logs/odc/logs
 - Windows： %USERPROFILE%\AppData\Roaming\odc\logs

### ODC V3.3.0 及之前的版本

在日志文件 main.log 中查看报错信息。日志的存放路径如下所示：

- Linux： ~/.config/odc/logs（客户端日志）；~/.config/odc/javalog（服务端日志）
 - macOS： ~/Library/Application Support/Logs/odc/logs（客户端日志）；~/Library/Application Support/Logs/odc/javalog（服务端日志）
 - Windows： %USERPROFILE%\AppData\Roaming\odc\logs（客户端日志）；%USERPROFILE%\AppData\Roaming\odc/javalog（服务端日志）

## **桌面版 ODC 安装或启动失败，提示 Java 版本问题时该如何解决？**

使用以下命令查看 Java 运行环境，ODC 需使用 JDK 1.8.0_242 及以上版本，若版本低于 1.8.0_242 请更新 JDK 并重启电脑后重新安装或启动：

```javascript
java -version

```

## **桌面版 ODC 安装或启动失败，提示软件包损坏该如何解决？**

通过sudo spctl --master-disable后，选择任何来源。

![3](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/4.faq/1.client-odc-installation-faq/3.png)

## **在 macOS 系统中安装 ODC 时，提示无法打开"OceanBase Development Center"。**

![4](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/4.faq/1.client-odc-installation-faq/4.png)

macOS 暂不支持直接安装，您可以参照 Apple 的支持文档查看如何安全的打开非通过 Apple Store 下载的应用，详情请参见文章[在 MacOS 上安全地打开 App](https://support.apple.com/zh-cn/guide/mac-help/mchleab3a043/mac)。

 上一篇 下一篇 ![有帮助](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) 咨询热线