Linux 查看端口#

1
ss -lntp | grep ':3000'
2
lsof -i :3000

ss 能看到监听状态和进程信息。没有权限时可能需要 sudo。

Windows 查看端口#

1
netstat -ano | findstr :3000
2
Get-Process -Id <PID>

释放端口#

如果确认占用进程可以停止，优先使用服务自己的停止命令或 systemctl stop。只有临时开发进程才考虑直接 kill。

1
kill -TERM <pid>
2
ss -lntp | grep ':3000' || echo 'port free'

改端口时同步配置#

如果选择改端口，要同步修改前端 API 地址、反向代理、环境变量和防火墙规则。只改启动命令，很可能导致服务启动了但访问不到。

实战复盘#

使用《服务端口占用排查》时，我会先确认环境边界：本地还是服务器，Windows 还是 Linux，开发环境还是线上环境。很多命令本身没错，但换了系统或权限就会得到完全不同的结果。

修复后不要只看报错消失，还要做业务层验证。比如端口释放后服务是否重新启动，缓存清理后页面是否显示新内容，pip 安装后目标环境是否真的能 import。

排查记录的质量取决于可复现性。只要别人能按文章从现象走到验证，这篇文章就不是临时笔记，而是一张可靠的操作卡片。

最小验收样例#

验收《服务端口占用排查》时，我会保留一条修复前命令和一条修复后命令。前者证明问题存在，后者证明问题已经消失，而不是只凭浏览器或终端感觉判断。

如果这篇文章涉及服务器操作，还要记录当前路径、用户、服务名和关键配置文件。排查记录越能还原现场，下次遇到同类问题越不需要重新摸索。

小结#

端口冲突要先定位进程，再决定停止还是换端口。线上环境尤其要避免误杀正在工作的服务。