You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Gatsby Cloud CMS预览报错EADDRINUSE:127.0.0.1:8888端口占用如何解决

排查解决方法
  • 终止占用8888端口的进程
    macOS/Linux环境执行命令:lsof -ti:8888 | xargs kill -9
    Windows环境先执行netstat -ano | findstr :8888找到占用端口的进程PID,再执行taskkill /PID 对应PID号 /F终止进程
  • 修改Gatsby预览启动端口:如果8888端口被其他必须运行的服务占用,可以在启动预览的命令末尾添加--port 8889切换到其他未被占用的端口,也可以检查gatsby-config.js、gatsby-node.js配置文件中是否有硬编码8888端口的逻辑,修改为自定义端口即可
  • 检查Gatsby Cloud预览配置:确认你在Gatsby Cloud后台配置的预览启动命令是否存在重复启动服务的逻辑,比如同时触发了开发服务启动和预览服务启动的两个命令,会导致同一个端口被两次申请占用
  • 排查第三方插件冲突:暂时禁用所有CMS对接类、预览增强类Gatsby插件后重试预览,如果问题消失,逐个启用插件定位到导致端口占用的插件,替换为兼容版本或者调整插件配置
官方反馈渠道
  • 你可以在Gatsby的官方GitHub仓库提交Issue,提交时附上完整的报错日志、Gatsby版本信息、package.json依赖配置、复现步骤即可
  • 若你使用的是Gatsby Cloud付费版本,可直接在后台提交工单获取官方技术支持

内容的提问来源于stack exchange,提问作者Max Frederiksen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.28 11:27:04