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

- 简体中文
- English

划线反馈

# 桌面版 ODC 安装或启动失败，提示端口冲突

更新时间：2025-06-17 09:01

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

## 问题现象

安装或启动桌面版 ODC 失败，提示端口冲突。

## 问题原因

查看占用了端口号 8989 的进程，关闭相关进程后重新安装或启动。ODC V2.3.0 及以上版本采用动态端口技术，不会出现该类问题。

## **解决方法**

1. 使用以下命令在 MAC 系统下查看端口号占用情况：

   ```javascript
   lsof -i tcp:8989

   ```
 2. 使用以下语句在 Win 系统下查看端口号占用情况：

   ```javascript
   netstat -ano|findstr 8989

   ```

ODC V3.2.0 支持自定义端口设置：

- MAC 系统下需设置环境变量后通过命令启动：

   ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/3.common-troubleshooting/6.client-odc-problems/8.prompt-port-conflict-when-installation-or-startup-fails/1.png) ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/odc/KB/3.common-troubleshooting/6.client-odc-problems/8.prompt-port-conflict-when-installation-or-startup-fails/2.png)
 - Windows 通过环境变量设置

  ODC_MAPPING_PORT 指定端口生效：

   ![](https://obbusiness-private.oss-cn-shanghai.aliyuncs.com/doc/img/knowledge-base/odc/600.client-odc-problems/1000.prompt-port-conflict-when-installation-or-startup-fails/3.png)

Previous

[桌面版 ODC 内存占用较高](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000262318)

Next

[桌面版 ODC 启动失败，Java 进程异常退出](https://www.oceanbase.com/knowledge-base/oceanbase-database-1000000000685395) ![有帮助](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) 咨询热线