---
title: 桌面版 ODC 启动失败/无响应 -OceanBase数据库使用指南
description: 了解OceanBase数据库在实际应用中关于桌面版 ODC 启动失败/无响应 相关的常见问题和使用技巧，帮助您快速解决桌面版 ODC 启动失败/无响应 的难题。
---
切换语言

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

划线反馈

# 桌面版 ODC 启动失败/无响应

更新时间：2023-11-14 07:11

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

## **问题现象**

打开桌面版 ODC 后，超出一分钟停留在 loading 页面。

![1](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/3.common-troubleshooting/6.client-odc-problems/4.failed-to-start-or-not-responding/1.png)

## **问题原因**

- 防火墙禁用本地端口。
 - 系统中仍存在历史的 ODC 进程。
 - Java 版本不正确。

## **解决方法**

### **本地端口被防火墙禁用**

1. 关闭防火墙。
 2. 如果无法关闭防火墙，需要确保 8989-8999,9989-9999,10089-10099,12089-12099 其中的端口至少一个可用，并通过设置环境变量 ODC_PORT(ODC V4.0.0 之前的版本) /`ODC_MAPPING_PORT`(ODC V4.0.0 及之后的版本) 来指定 ODC 的端口号。

### **系统中仍存在历史的 ODC 进程**

1. 打开任务管理器，关闭所有 ODC 相关的进程后，重启任务管理器以确保完全关闭所有 ODC 相关的进程。
 2. 重新启动 ODC。

### **Java 版本不正确**

确保本地的 Java 版本大于 1.8.0_200。

### **其它方法**

如上述方法无效，请联系 OceanBase 技术支持并提供日志协助解决。

#### ODC V3.3.0 及之后版本的日志地址

- MacOS：~/Library/Application Support/odc/logs/ 下的 server 和 client 子目录，其中 ~ 通常为 /Users/{username} 。
 - Windows：%USERPROFILE%\AppData\Roaming\odc\logs\ 下的 server 和 client 子目录，其中 %USERPROFILE% 通常为 C:\Users{username}\ 。

#### ODC 2.3.0~3.2.x 版本的日志地址

- MacOS：~/Library/Application Support/odc/ 下的 logs 和 javaLog 子目录，其中 ~ 通常为 /Users/{username} 。
 - Windows：%USERPROFILE%\AppData\Roaming\odc\ 下的 logs 和 javaLog 子目录，其中 %USERPROFILE% 通常为 C:\Users{username}\ 。

#### ODC 2.2.x 及之前版本的日志地址

- MacOS：/Users/{user}/Library/Application Support/odc-sql-console/logs 下的 logs 和 javaLog 子目录 。
 - Windows：%USERPROFILE%\AppData\Roaming\odc-sql-console\logs，其中 %USERPROFILE% 通常为 C:\Users{username}\。

上一篇

[桌面版 ODC 安装失败](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000262314)

下一篇

[桌面版 ODC 新建连接时报错 Not a valid secret key](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000262316) ![有帮助](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) 咨询热线
