启动失败后看到“端口被占用”,不要马上结束一串进程。占用端口的可能是昨天没关的项目,也可能是你正在使用的数据库或另一个开发工具。先确认对象,再决定怎么处理。
先记录报错中的端口
到 Devio 的“设置 → 系统设置”中检测端口,把检测结果和启动日志放在一起看。重点核对报错发生时的端口、准备启动的服务,以及检测到的占用来源。
如果日志没有明确端口,先查项目配置或启动输出。不要默认所有网站都使用同一个端口,也不要把 Nginx 的监听端口和应用自己的目标端口混在一起。
判断是不是同一个项目开了两次
回忆这个项目是否已经在终端、编辑器或另一个工具里启动。Devio 中启动失败,不代表外部启动的那一份也已经停止。
如果确认是自己先前启动的同一个项目,回到原来启动它的地方正常停止,然后在 Devio 中再启动。对正在写入数据或执行任务的进程,先等任务结束。不要只凭进程名称相似就强制结束。
两个项目都要运行时,再调整端口
- 先确认两个服务分别属于哪个项目,哪些访问地址仍在使用。
- 为需要调整的应用选择一个未占用端口,具体端口由你自己的环境决定。
- 检查项目如何接收端口配置:可能通过启动参数、环境变量或配置文件。Devio 中填写的目标端口要和应用实际监听的端口一致。
- 重启受影响的项目,查看启动日志,确认新端口已经生效。
- 先验证直接端口,再验证 Devio 中配置的站点域名。
只改 Devio 的目标端口,未必会自动改变项目内部的监听设置。反过来,只改了应用端口,原来的代理目标也可能继续指向旧地址。两边要一起核对。
数据库端口别跟着随手改
如果冲突涉及 MySQL 等共享服务,先检查哪些项目连接着这个实例。调整服务端口后,应用连接配置和数据库客户端也可能需要同步修改。不能为了让一个项目启动,就让其他项目突然连不上数据库。
拿不准占用进程属于谁时,先停在这里,把检测结果和相关日志整理出来再处理。保留正在正常工作的环境,比盲目清空端口更重要。
最后确认没有“连错项目”
打开页面后,核对内容确实来自当前项目,再测试一个实际功能。端口恢复可用只是第一步,访问到旧项目的页面并不算排查完成。
发表回复