Docker容器启动报错“端口5000已占用”，但主机无进程占用该端口

你遇到的问题核心是容器内部的5000端口被占用，而非主机端口——这也是更换主机映射端口后错误依然存在的原因。以下是针对性的排查和解决步骤：

排查方向及解决方案 #

1. 清理残留容器进程 #

停止并删除当前容器，确保启动全新实例：

docker stop <容器ID/名称>
docker rm <容器ID/名称>

重新启动容器：

docker run -d -p 6000:5000 -e PORT=5000 <你的镜像名称>

2. 检查Node.js代码的端口监听逻辑 #

确认代码中没有重复监听端口的情况（比如多次调用app.listen()）。建议通过环境变量动态指定端口，避免硬编码：

const port = process.env.PORT || 5000;
app.listen(port, () => {
  console.log(`Server is running on port ${port}`);
});

3. 进入容器内部排查端口占用 #

启动临时容器进入交互模式，直接查看容器内的端口使用情况：

docker run -it --rm <你的镜像名称> sh
# 在容器内执行端口检查命令
ss -tuln | grep 5000
# 查看容器内所有进程
ps aux

找到占用5000端口的进程，针对性调整应用或镜像配置。

4. 检查Docker网络内的端口冲突 #

如果容器加入了自定义Docker网络，查看同网络内其他容器是否占用5000端口：

# 查看容器所属网络
docker inspect <容器ID/名称> | grep Networks
# 列出目标网络内的所有容器
docker network inspect <网络名称> | grep Name

若存在冲突，要么修改其他容器的端口，要么通过-e PORT=5001指定你的应用使用其他端口。

内容的提问来源于stack exchange，提问作者Dinithi Yapa