查看端口占用进程的命令及解决方法

当 systemctl 启动服务报“Address already in use”错误时，本质是目标端口被其他进程意外占用，需通过 journal 日志精准提取端口号，再用 ss 或 lsof 定位 PID，接着深入 /proc 文件系统验证进程身份、启动方式及所属用户，关键一步是区分该进程是否由 systemd 托管——若非托管（如手动运行的 Python/Java 服务），才可安全发送 SIGTERM 或必要时 SIGKILL 终止；整套流程兼顾准确性与安全性，避免误杀系统服务或导致数据异常，助你快速恢复服务正常启动。

如果您使用 systemctl 启动某个服务时失败，并显示 Address already in use 错误，则说明该服务尝试绑定的网络端口已被其他进程占用。以下是定位并确认占用进程的具体操作步骤：

一、提取报错中的目标端口号

该步骤旨在从 systemctl 的错误日志中准确识别被占用的端口，这是后续排查的前提。systemctl 服务启动失败时，错误通常出现在 journal 日志中，其中包含 bind 失败的具体地址和端口信息。

1、执行命令查看最近一次服务启动失败的完整日志：
journalctl -u 服务名.service --since "1 hour ago" | grep -i "address.*already.*use"

2、在输出中查找形如 bind() to 0.0.0.0:8080 failed 或 listen tcp :3000: bind: address already in use 的行

3、从中提取出冒号后的数字，即目标端口号（例如 8080、3000、7861 等）

二、在 Linux 系统中查找占用该端口的进程

Linux 提供多种命令可列出监听指定端口的进程，需结合权限与系统版本选择合适方式。普通用户可能无法看到所有进程，建议使用 sudo 执行。

1、使用 lsof 命令（需安装 lsof 包）：
sudo lsof -i :端口号

2、使用 ss 命令（推荐，现代系统默认可用）：
sudo ss -tulnp | grep ':端口号'

3、使用 netstat 命令（部分新发行版已弃用）：
sudo netstat -tulnp | grep ':端口号'

三、验证进程身份与运行上下文

仅获取 PID 不足以安全操作，必须确认该进程是否为非关键服务或残留进程，避免误杀系统服务。通过检查其启动路径、工作目录及命令行参数，可判断其来源和用途。

1、根据上一步获得的 PID（例如 12345），执行：
ls -l /proc/12345/exe

2、查看进程当前工作目录：
ls -l /proc/12345/cwd

3、查看完整启动命令行：
cat /proc/12345/cmdline | tr '\0' ' '

4、检查进程所属用户及启动时间：
ps -o pid,user,lstart,cmd -p 12345

四、区分 systemd 托管进程与独立进程

若查得的 PID 对应一个由 systemd 管理的其他服务（如 nginx、redis、docker-proxy），则不能直接 kill，而应通过 systemctl 控制；若为孤立进程（如前台运行的 python server、java -jar 进程），则可按需终止。

1、检查该 PID 是否属于某个 systemd 单元：
systemctl status 12345

2、若返回 “Unit … not found”，说明不是 systemd 托管进程，可继续下一步操作

3、若返回有效单元信息（如 “● nginx.service”），则需决定是否停止该服务：
sudo systemctl stop nginx.service

五、安全终止非托管占用进程

对确认为非关键、非 systemd 托管的进程，可发送标准终止信号；若无响应，再使用强制终止。注意：不建议跳过 SIGTERM 直接使用 SIGKILL，以免数据丢失。

1、向进程发送终止信号（允许其正常退出）：
kill 12345

2、等待数秒后检查是否仍存在：
sudo ss -tulnp | grep ':端口号'

3、若端口仍被占用，执行强制终止：
kill -9 12345

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~