VSCode特定工作区运行Docker/Postgres报无有效端口如何排查

这个报错和Postgres业务配置无直接关联，优先按以下顺序调试：

• 修正docker-compose.yml中的不规范端口配置
  你当前db服务的端口配置为- 5432，仅声明容器端口未指定宿主机映射端口，这种写法会让Docker随机分配宿主机高位端口，但VS Code Docker扩展的端口探测逻辑对这类半声明的端口规则兼容性极差，很容易出现识别失效抛出上述错误。另外你在db服务里同时写了expose和ports，expose仅用于容器间通信声明，在配置了ports映射的场景下完全冗余，可一并删除。
  两种修复方式二选一：
  • 直接删除db服务下的ports和expose配置段：你的db服务已经加入mos-db-nw隔离桥接网络，同网络下的web、adminer服务可直接通过服务名db:5432访问数据库，无需映射端口到宿主机，安全性更高
  • 若确实需要本地直连数据库，明确指定宿主机映射端口，写成- "5432:5432"，注意用字符串格式包裹避免YAML解析异常，此时可保留或删除expose配置，不影响实际运行
• 排查常用端口占用
  配置中声明的80、8080都是系统常用端口，很可能被本地其他服务（本机Nginx、其他运行中容器、系统预留服务）占用：
  • Windows环境执行netstat -ano | findstr ":80 "、netstat -ano | findstr ":8080 "查对应端口占用进程
  • macOS/Linux环境执行lsof -i:80、lsof -i:8080查占用
    若端口被占用，要么终止占用进程，要么修改compose中对应服务的映射端口为未被占用的高位端口（比如把loadbalancer端口改成- "8090:80"）
• 清理工作区Docker扩展缓存
  其余项目运行正常仅当前项目报错，大概率是扩展在当前工作区留存了错误的端口缓存：
  1. 终端执行docker compose down停掉当前项目所有容器，清除关联临时网络
  2. 关闭VS Code，打开项目根目录下的.vscode隐藏文件夹，删除所有docker相关的缓存配置文件
  3. 重启VS Code重新加载Docker扩展后，再启动容器测试
• 绕过扩展验证服务可用性
  不要点击Docker扩展提供的"在浏览器中打开"按钮，容器启动后手动在浏览器地址栏输入映射的服务地址（比如默认配置下输http://localhost），如果能正常访问，说明故障完全是VS Code Docker扩展的端口识别bug导致，和容器、应用本身无关，可临时手动输入地址访问，或通过升级/回退Docker扩展版本解决。

关于是否和Postgres配置相关的说明 #

该故障和Postgres本身的运行参数、数据初始化、权限配置没有任何关系。Postgres服务只要正常启动、在所属网络内开放5432端口即可满足业务通信要求，本身不会干涉宿主机端口分配、也不会影响VS Code扩展的端口探测逻辑。唯一和Postgres服务相关的问题点是前面提到的不规范端口映射写法，属于compose配置格式问题，和Postgres数据库本身无关。

附当前使用的docker-compose配置参考：

version: "3"
services:
  # database
  loadbalancer:
    build: deploy/nginx
    ports:
      - 80:80
    depends_on:
      - web
    volumes:
      - ./run/static/:/var/www/mos_rms_app_prod/static
    networks:
      - mos-web-nw

  db:
    image: postgres:13.0
    expose:
      - 5432
    ports:
      - 5432
    # persistent db
    volumes:
      - prod-db-data:/var/lib/postgresql/data
    env_file:
      - .env
    networks:
      - mos-db-nw

  # db GUI
  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080
    networks:
      - mos-db-nw

#   web application
  web:
    build: .
    image:  mos_rms_app_prod:v0.1.0
    volumes:
      - .:/mos-rms
    env_file:
      - .env
    depends_on:
      - db
    networks:
      - mos-db-nw
      - mos-web-nw
networks:
  mos-db-nw:
    driver: bridge
  mos-web-nw:
    driver: bridge

volumes:
  prod-db-data:

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