layui提示Error: listen EADDRINUSE在本地启动Layui调试服务器时怎么改端口

胖丽君_4763

胖丽君_4763

2026-11-09

835人浏览

原创

EADDRINUSE表示端口已被占用,需先查清占用进程并终止,再通过修改package.json脚本或环境变量(如PORT=8081)调整启动端口,避免残留node进程导致问题复发。

layui提示error: listen eaddrinuse在本地启动layui调试服务器时怎么改端口

直接改 npm run serve 启动的端口就行,Layui 本身不带服务器,你遇到的 Error: listen EADDRINUSE 实际来自它依赖的前端构建工具(比如 Vue CLI、Vite 或 webpack-dev-server),不是 Layui 的错。

查清到底是哪个工具在监听端口

Layui 是纯前端 UI 库,没内置 dev server。你本地启动调试服务,大概率是用了以下之一:

  • Vue CLI 项目(vue create 创建):默认走 webpack-dev-server,端口 8080
  • Vite 项目(npm create vite@latest):默认端口 5173
  • 用 http-server 或 live-server 手动起的服务:端口通常 8080 / 3000 / 8000

报错里出现的 :::8080 或 0.0.0.0:5173 就是线索——先看终端错误完整行,抓出那个端口号。

改 package.json 里的启动命令

找到项目根目录下的 package.json,看 "scripts" 里 "serve" 或 "dev" 对应的命令:

  • 如果是 Vue CLI:"serve": "vue-cli-service serve" → 改成 "serve": "vue-cli-service serve --port 8081"
  • 如果是 Vite:"dev": "vite" → 改成 "dev": "vite --port 5174"
  • 如果是 http-server:"dev": "http-server -p 8080" → 改成 "dev": "http-server -p 8082"

改完保存,再运行 npm run serve(或对应 script 名)即可生效。不需要重启终端或清缓存。

不想每次改命令?用环境变量更灵活

某些工具支持环境变量覆盖端口,比硬编码更可持续:

深蓝色网站后台管理系统layui框架模板-AdminPro
深蓝色网站后台管理系统layui框架模板-AdminPro

一款深蓝色网站后台管理系统layui框架模板

下载
  • Vue CLI:启动前设 PORT=8081(macOS/Linux)或 set PORT=8081(Windows),再 npm run serve
  • Vite:同样认 PORT=5174,且会自动 fallback 到下一个可用端口(加 --strictPort 可禁用该行为)
  • 注意:http-server 不读 PORT 环境变量,必须显式传 -p

这种写法适合团队协作或 CI 场景,避免把端口写死在脚本里。

为什么改了还报 EADDRINUSE?检查残留 node 进程

常见但容易被忽略的情况:上次 Ctrl+C 没真正杀掉进程,它还在后台占着端口。

  • macOS/Linux:运行 lsof -i :8080(把 8080 换成你报错的端口),看有没有 node 进程;有就 kill -9 [PID]
  • Windows:运行 netstat -ano | findstr :8080,找 PID,再 taskkill /PID [PID] /F
  • 通用清理:执行 pkill -f "node.*serve\|vite\|http-server"(macOS/Linux)或 taskkill /IM node.exe /F(Windows,慎用,会杀所有 node)

尤其用过 nodemon 或频繁保存触发热重载的场景,残留概率很高——别只盯着改端口,先确认端口真空着。

真正卡住的点往往不在配置,而在你以为“已经停了”的那个旧进程。查 lsof 或 netstat 一眼就能验证,比反复改端口号快得多。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

layui layui菜鸟教程

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2903

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

6343

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

7250

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

7098

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

1003

5

服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

457

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

980

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

3492

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

1136

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
ThinkPHP配置开发与CMS后台实战
ThinkPHP配置开发与CMS后台实战

共87课时 | 13.2万人学习

第二十三期_综合实战
第二十三期_综合实战

共89课时 | 11.5万人学习

Layui 快速入门精讲
Layui 快速入门精讲

共5课时 | 1.6万人学习