讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

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

胖丽君_4763

胖丽君_4763

发布时间:2026-11-09 09:32:08

|

835人浏览过

|

来源于php中文网

原创

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 一眼就能验证,比反复改端口号快得多。

热门AI工具

更多
超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

相关专题

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

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

2903

2023.08.11

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

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

6343

2023.10.09

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

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

7250

2024.03.19

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

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

7098

2024.03.22

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

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

1003

2024.05.22

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

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

457

2023.08.15

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

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

980

2023.09.08

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

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

3492

2023.09.19

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

40

2026.11.06

热门下载

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

精品课程

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

共87课时 | 13.2万人学习

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

共89课时 | 11.5万人学习

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

共5课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn