Docker更新后端口8000提示已占用但netstat未检测到的问题

问题背景 #

时隔数月重新接手项目，首次使用Docker。最初一切正常，将Docker从4.08.xxxx版本更新至4.11.1（84025）后，开机执行docker-compose up --build时backend服务无法启动，报错如下：

Cannot start service backend: driver failed programming external connectivity on endpoint admin_backend_1 (846b1b7447d5108e41ca67307eaa65fae143dc2c005fffe7b8c9da476c3b60e1): listen tcp4 0.0.0.0:8000: bind: address already in use
ERROR: Encountered errors while bringing up the project

但执行netstat -a -b -o未检测到任何服务监听0.0.0.0:8000（见下图）：

已尝试的操作 #

• 使用netstat查找监听8000端口的服务
• 执行docker-compose down停止所有容器
• 重启电脑
• 修改docker-compose.yml中的端口映射为8003:8000（可临时解决，但未根治）

附docker-compose.yml内容 #

version: '3.8'

services: 
  backend:
    build:
      context: .
      dockerfile: Dockerfile
    command: 'python manage.py runserver 0.0.0.0:8000'
    ports:
      - 8000:8000
    volumes:
      - .:/app
    depends_on:
      - db

  queue:
    build:
      context: .
      dockerfile: Dockerfile
    command: 'python consumer.py'
    depends_on:
      - db

  db:
    image: mysql:5.7.38
    restart: always
    environment:
      MYSQL_DATABASE: admin
      MYSQL_USER: user
      MYSQL_PASSWORD: user
      MYSQL_ROOT_PASSWORD: root
    volumes:
      - .dbdata:/var/lib/mysql
    ports:
      - 33066:3306

问题原因分析 #

1. Docker网络驱动残留：Docker更新后，旧版本的网络驱动可能残留端口占用记录，系统判定8000端口被占用，但netstat无法检测到（属于Docker内部虚拟端口占用）。
2. WSL2端口映射残留（Windows环境）：若使用WSL2作为Docker后端，更新后可能出现WSL2与主机的端口映射未清理，重启电脑也无法解决。
3. Docker守护进程缓存：Docker守护进程缓存了旧的端口绑定信息，更新后未自动重置。

彻底解决方法 #

方法一：重置Docker网络 #

1. 停止所有运行容器：docker stop $(docker ps -aq)
2. 删除所有容器：docker rm $(docker ps -aq)
3. 清理所有无用Docker网络：docker network prune -f
4. 重启Docker守护进程（Windows右下角托盘右键Docker图标，选择Restart）
5. 重新执行docker-compose up --build

方法二：排查WSL2端口占用（Windows环境） #

1. 打开PowerShell进入WSL2：wsl
2. 在WSL2内执行netstat -tulpn | grep :8000，查看是否有进程占用端口
3. 若找到对应进程，执行kill -9 <PID>终止进程
4. 退出WSL2，重启Docker后重新启动项目

方法三：修改端口绑定地址 #

不想重置网络的话，可将docker-compose.yml中的端口映射改为绑定本地IP，避免占用0.0.0.0的8000端口：

ports:
  - 127.0.0.1:8000:8000

这样仅允许本地访问容器端口，降低冲突概率。

方法四：回退Docker版本 #

若以上方法无效，可尝试回退至之前的Docker 4.08.xxxx版本，确认是否为新版本bug导致问题。

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