Linux端口被占用,程序启动不了怎么办
程序启动的完整报错包含Address already in use或EADDRINUSE时,先找出失败的地址、端口和协议。本篇按固定端口冲突排查;单纯增加安全组规则,并不能释放已被占用的端口。
如果只看到bind failed,先展开后面的具体原因。比如Permission denied属于权限问题,不能直接当作端口被其他程序占用。
以下以TCP 8080端口为例,在报错程序所在的Linux服务器上执行。把8080换成实际端口,PID和服务名也要按查询结果替换。查看其他用户的进程信息通常需要sudo权限。
把协议和端口对上
TCP用第一条,UDP用第二条;两条都是查询命令:
sudo ss -ltnp 'sport = :8080'
sudo ss -lunp 'sport = :8080'
重点看Local Address:Port以及末尾的程序名和pid=。同一个数字的TCP端口和UDP端口不是同一个监听对象。还要留意127.0.0.1、0.0.0.0和IPv6地址;不同监听地址可能发生范围重叠,不能只比较程序名称。
若只显示表头,先确认日志时间、端口和运行位置。程序可能正在退出、被托管工具反复拉起,或者冲突发生在容器自己的网络环境中。宿主机的一次查询没有结果,不足以证明容器里没有冲突。若日志写的是Unix套接字路径,也不能套用TCP端口命令,更不要直接删除该路径。
这个PID由谁管理
把1234换成查到的PID。第一条看启动命令,第二条适用于使用systemd的系统:
ps -p 1234 -o pid,ppid,etime,args
sudo systemctl status 1234 --no-pager
核对程序目录、启动参数,以及它是否属于预期服务。如果结果只是登录会话的scope,不要把整个会话当作业务服务停止。PID可能在重启后改变,真正操作前应再核对一次。
服务器使用Docker时,还应使用已有的Docker管理权限查看宿主机端口映射:
docker ps --format 'table {{.Names}}\t{{.Ports}}'
例如0.0.0.0:8080->80/tcp表示宿主机8080被映射到容器80;只显示80/tcp并不等于宿主机8080已发布。若确认冲突来自容器,应修改对应项目的映射或按该项目流程停止旧容器,不要结束docker-proxy,也不要重启整台Docker服务来清端口。
选择释放旧实例,还是调整端口
| 确认的情况 | 处理方法 |
|---|---|
| 同一程序已经正常运行,又手动启动了一份 | 保留原实例,停止重复启动动作;以后统一从原来的服务管理入口操作。 |
| 旧版本仍在运行,需要交接给新版本 | 先安排停机或切换窗口,按原托管方式停止旧实例,再启动新实例。 |
| 端口属于另一项仍需要使用的业务 | 给新程序选择空闲端口,并同步反向代理、健康检查和调用端配置。 |
例如,已确认准备下线的旧实例由myapp.service管理,才使用下面的停止命令。它会中断该服务,名称必须替换为实际业务单元:
sudo systemctl stop myapp.service
停止后若端口马上被新PID占用,继续检查原托管工具、自动重启策略或socket激活关系,不要反复杀进程。手动运行的程序应使用它自己的退出方式,具体可看Linux定位进程并安全停止程序。
选择新端口时,保留业务原本需要的监听范围;本来只供本机代理访问的程序,不必为了避开冲突改成监听所有公网地址。
新程序启动后,还要验收一次
按原部署方式启动目标服务后,重新查看端口和服务状态:
sudo ss -ltnp 'sport = :8080'
sudo systemctl status myapp.service --no-pager
确认监听者确实是新实例,日志里不再出现端口绑定失败,再访问一个实际业务页面或健康检查接口。若本机启动成功但外部仍访问不到,转到Linux端口不通排查;服务管理操作见systemd服务启动、重载与开机自启。