Docker使用中如何避免端口冲突？Node应用部署报错排查

我来帮你梳理下这个问题，你遇到的端口冲突其实是Docker端口映射的常见误区，咱们一步步拆解：

你的docker-compose.yml存在的问题 #

首先看你的配置，有两个需要调整的点：

• 端口映射导致主机端口冲突：你给mysql服务配置了ports: "3306:3306"，这个指令的作用是把容器内部的3306端口绑定到主机的3306端口。容器本身确实和主机系统隔离，但端口映射是在主机层面建立转发，这时候主机上的gitlab-runner已经占用了3306端口，自然就会冲突。
• links指令已过时：Docker Compose早就弃用了links来实现服务间通信，现在推荐用depends_on定义启动依赖，而且容器之间可以直接通过服务名（比如mongo、mysql）互相访问，完全不需要links。

为什么会出现端口冲突？ #

Docker的容器网络隔离是指容器内部的网络栈独立于主机，但当你使用ports做端口映射时，相当于在主机的网卡上监听指定端口，然后把流量转发到容器内部的对应端口。这时候主机的端口空间是所有进程共享的，不管是主机原生进程还是Docker的端口代理，只要占用了同一个端口就会报错。

其他可能的原因 #

除了gitlab-runner占用端口，还有这些情况也会导致类似错误：

• 主机本地安装了MySQL/MariaDB服务，并且正在运行，占用了3306端口
• 之前启动过的mysql容器没有彻底停止，残留的容器进程还在占用端口（可以用docker ps -a查看所有容器状态）
• 端口映射语法错误：比如不小心把顺序写反成"containerPort:hostPort"，不过你这里的写法是对的
• 系统防火墙或安全软件限制了端口绑定（不过这种情况通常会报权限错误，而非地址已占用）

解决方案 #

针对你的情况，推荐这几种解决方式：

1. 修改MySQL的端口映射 #

把主机端口改成一个未被占用的端口，比如33060，容器内部依然用3306端口。Node应用连接MySQL时，直接用服务名mysql和端口3306即可（容器间通信不需要用主机端口）：

mysql:
  container_name: mysql
  image: mysql
  ports:
    - "33060:3306"

2. 移除不必要的端口映射 #

如果不需要从主机直接访问MySQL（比如只需要Node应用内部连接），可以直接删掉ports字段。容器之间通过服务名就能互相访问，这样完全不会占用主机端口，从根源避免冲突：

mysql:
  container_name: mysql
  image: mysql

3. 停止占用3306的进程 #

如果你确实需要主机3306端口，可以停止gitlab-runner中占用该端口的服务，或者修改gitlab-runner的MySQL配置，让它使用其他端口。

4. 替换过时的links指令 #

用depends_on来确保mongo和mysql服务先于app启动，同时容器间通信直接用服务名：

app:
  container_name: app
  restart: always
  build: .
  volumes:
    - ./:/app
  ports:
    - "3000:3000"
  depends_on:
    - mongo
    - mysql

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