HarmonyOS鸿蒙Next中运行时提示“Hdc server port XXXX has been used”,按照操作步骤未解决

HarmonyOS鸿蒙Next中运行时提示“Hdc server port XXXX has been used”,按照操作步骤未解决

  1. 开发工具启动时，弹窗报错。

cke_152.png

  1. 按照操作步骤(https://developer.huawei.com/consumer/cn/doc/harmonyos-faqs/faqs-app-debugging-19) 检查，检查结果如图下图：

cke_7709.png

根据PID 到任务管理器中，查询如下：

cke_12611.png

该进程号是hdc使用，为何还要提示被占用？


更多关于HarmonyOS鸿蒙Next中运行时提示“Hdc server port XXXX has been used”,按照操作步骤未解决的实战教程也可以访问 https://www.itying.com/category-93-b0.html

12 回复

这种一般是系统问题 ， 看你发的都是没问题的；

更多关于HarmonyOS鸿蒙Next中运行时提示“Hdc server port XXXX has been used”,按照操作步骤未解决的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


关闭防火墙，解决了。

你卸载掉，然后把之前数据全部清空掉，重新安装试试

最终，我把防火墙关闭了，解决了，

我按照操作步骤，将环境变量设置成未使用的7099。设置完成后，重新启动DevEco开发工具，启动还是报错。截图分别如下。

环境变量：

cke_7066.png

启动报错：

cke_6726.png

控制台查询：

cke_8765.png

根据PID定位程序：

cke_12125.png

请大家在帮我分析分析！ 感谢。

手动把hdc.exe结束试试。

可能是启动了新的hdc实例但是端口被旧的hdc占用了？

按照你的方法后，仍未解决，还是一样的报错。

那就改成其他的端口号试试，

按照环境变量设置，还是报错。

按照要求配置环境变量，仍未解决。

HDC端口冲突导致。可尝试以下步骤：

  1. 检查端口占用：在命令行执行netstat -ano | findstr XXXX（Windows）或lsof -i:XXXX（macOS/Linux），找到占用进程PID。
  2. 终止占用进程：通过任务管理器或kill -9 PID结束对应进程。
  3. 重启HDC服务：执行hdc kill或hdc start重启服务。
  4. 若仍无效，可更换HDC端口：在DevEco Studio设置中修改hdc.port为其他未占用端口。

这个报错是因为HDC Server的端口被占用了。从你提供的截图来看，虽然你通过 netstat -ano | findstr 8710 命令查到了占用端口8710的进程PID，并且在任务管理器中确认该PID对应的进程是 hdc.exe，但问题依然存在。这通常表明存在一个“僵尸”或状态异常的HDC进程实例，它虽然占用了端口，但可能已经无法正常响应或通信。

标准的解决步骤（如文档所述）是结束占用端口的进程。既然你已确认该进程就是 hdc.exe 本身，那么最直接有效的解决方法是：

  1. 强制结束HDC相关进程：在任务管理器中，选中该 hdc.exe 进程，点击“结束任务”。如果无法直接结束，可以尝试以管理员身份打开命令提示符或PowerShell，使用命令 taskkill /f /pid <PID>（将 <PID> 替换为实际的进程ID，例如你截图中的 13036）来强制结束它。

  2. 重启开发工具：结束进程后，完全关闭你的DevEco Studio或其他HarmonyOS开发工具，然后重新启动。工具重启时会自动尝试重新启动一个健康的HDC Server进程。

核心原因分析：出现这种情况，通常是因为之前HDC进程（例如由于调试会话异常中断、工具非正常关闭等）未能完全退出并释放资源，导致其进程残留并锁定了端口。新启动的开发工具尝试绑定同一端口时就会发生冲突。

你按照官方文档的排查思路是正确的，问题在于执行环节——需要结束的正是这个已存在的 hdc.exe 进程本身。结束它并重启工具即可解决端口占用冲突。

回到顶部