鸿蒙Next项目启动失败，端口被占用怎么办

启动鸿蒙Next项目时提示失败，报错显示端口被占用。请问如何快速检查是哪个程序占用了端口？有没有命令行工具可以直接终止占用端口的进程？另外，鸿蒙开发中是否有推荐修改默认端口的方法避免冲突？

2 回复

端口被占？别慌，程序员老司机教你三招：

  1. 查凶手：netstat -ano | findstr :端口号（Windows）或 lsof -i :端口号（Mac/Linux），揪出占用进程。
  2. 关进程：taskkill /PID 进程号 /F（Windows）或 kill -9 进程号（Linux/Mac）。
  3. 换端口：改配置文件，换个没人用的端口，比如从8080换成8088。

搞定！代码继续跑，咖啡继续喝 ☕️

更多关于鸿蒙Next项目启动失败，端口被占用怎么办的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


当鸿蒙Next项目启动失败并提示端口被占用时，可以按以下步骤解决：

1. 查找占用端口的进程

在命令行中执行以下命令（以默认端口8080为例）：

# Windows系统：
netstat -ano | findstr :8080

# macOS/Linux系统：
lsof -i :8080

命令会返回占用8080端口的进程ID（PID）。

2. 终止占用进程

  • Windows：根据查到的PID，执行：
    taskkill /PID <进程号> /F
  • macOS/Linux：使用kill命令：
    kill -9 <进程号>

3. 更换项目端口

如果无法终止进程，可修改鸿蒙Next项目的配置文件（如app.json或build.gradle），将端口改为其他未占用值（例如8081）：

// 在app.json中修改
{
  "server": {
    "port": 8081
  }
}

4. 预防措施

  • 启动前通过命令检查端口占用情况。
  • 在IDE中配置动态端口分配（如DevEco Studio的设置选项）。

注意事项：

  • 确保操作权限足够（如管理员权限）。
  • 若为系统关键进程占用端口，请勿强制终止，改用更换端口方案。

完成后重新启动项目即可。

回到顶部