HarmonyOS鸿蒙Next中在设备中运行HAP时提示“Hdc server port XXXX已被使用。请配置环境变量‘OHOS_HDC_SERVER_PORT’并重启DevEco Studio。”

每一次启动的hdc位置打开都是E:\DevEco Studio\sdk\default\openharmony\toolchains\hdc.exe，这不就是DevEco Studio自带的hdc么，

这个其实不是“异常占用”，而是：

你自己启动的 DevEco Studio 内置 hdc 服务，把端口占用了。

很多人第一次看到这个提示会误以为：

“是不是有别的软件占了端口”。

但实际上：

hdc.exe

本来就是 DevEco Studio 自带的设备调试服务。

类似 Android 的：

adb server

它启动后一定会监听一个端口。

你现在的问题本质是：

系统里存在“多个 hdc server”。

最常见场景：

• 装过多个 DevEco Studio
• 装过 OpenHarmony SDK
• Win11 虚拟机也开着
• 配置过独立 hdc
• PATH 里有多个 hdc
• 老版本 hdc 没退出

于是：

新的 DevEco Studio 启动时发现：

端口已被另一个 hdc server 占用

所以才提示：

请配置 OHOS_HDC_SERVER_PORT

但你现在：

即使改了端口，

启动后还是被占用。

原因其实是：

“启动后的 hdc 自己占用了这个端口”。

这是正常现象。

真正的问题不是：

“端口被占用”。

而是：

“有多个 hdc 在抢同一个端口”。

解决方案：

第一步：先确认系统里有几个 hdc

Windows CMD：

where hdc

如果输出多个：

C:\DevEco\hdc.exe
D:\HuaweiSDK\hdc.exe
...

那就说明系统里多个 hdc。

这是最常见原因。

第二步：杀掉所有 hdc

CMD：

taskkill /F /IM hdc.exe

然后：

netstat -ano | findstr 8710

确认端口已经释放。

第三步：只保留一个 hdc

建议：

只使用：

DevEco Studio 自带 hdc

路径一般：

DevEco-Studio/sdk/default/openharmony/toolchains/hdc.exe

不要混用：

• 独立 hdc
• 老版本 SDK
• 虚拟机 hdc

第四步：设置环境变量（如果真冲突）

系统环境变量：

OHOS_HDC_SERVER_PORT=20351

然后：

彻底关闭 DevEco Studio。

注意：

不是点叉。

而是：

taskkill /F /IM hdc.exe
taskkill /F /IM deveco-studio64.exe

然后重新打开。

否则老 hdc 不会退出。

第五步：检查是否多个 DevEco 同时开

很多人：

• 宿主机开一个
• 虚拟机再开一个

两个 hdc 会直接冲突。

尤其：

Win11虚拟机 + 鸿蒙PC

特别容易出现。

另外还有一个 HarmonyOS 开发里的经典坑：

有时：

OHOS_HDC_SERVER_PORT

只改了系统变量，

但：

IDE 内部 hdc 还是旧端口。

这时候需要：

删除 hdc 缓存。

可以尝试删：

C:\Users\用户名\.hdc

或者：

C:\Users\用户名\AppData\Local\Huawei

然后重启。

最后说一下：

其实：

hdc.exe 占用端口

本身是正常行为。

因为 hdc 本来就是 server。

真正异常的是：

存在多个 hdc server

你现在大概率就是：

• 多版本 DevEco
• 虚拟机
• 独立 hdc
• PATH污染

其中之一导致的。