宿主机3306端口已占用，Docker容器MySQL仍占用该端口？

核心结论 #

容器内的MySQL并没有直接占用宿主机的3306端口，你遇到的冲突问题根源大概率是网络模式配置导致的。

问题原因 #

• 你的Docker Compose配置中可能设置了network_mode: host。当使用host网络模式时，容器会直接共享宿主机的网络命名空间，容器内进程监听的端口会直接占用宿主机对应端口。此时容器里的MySQL默认监听3306端口，自然会和宿主机上已运行的MySQL端口冲突——哪怕你注释掉端口映射配置也没用，因为这种模式下端口映射逻辑本身就不生效。
• 极少情况下可能是配置残留或自定义镜像的问题，比如未完全清理的旧端口绑定配置，或是镜像内部强制绑定宿主机3306端口，但这类情况非常罕见。

验证与解决方法 #

• 检查docker-compose.yml文件，确认是否存在network_mode: host配置，若有则删除，改用Docker默认的bridge模式（容器拥有独立网络空间，端口映射仅关联指定宿主机端口）。
• 确保端口映射配置正确，示例如下：

  services:
    mysql:
      image: mysql:latest
      ports:
        - "3309:3306"  # 宿主机3309端口映射到容器内3306端口
      environment:
        MYSQL_ROOT_PASSWORD: your_root_password
  

• 使用bridge模式时，容器内的MySQL监听3306端口仅在容器内部网络生效，不会直接占用宿主机端口，只会通过ports配置关联宿主机3309端口，完全不会和宿主机的3306端口产生冲突。

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