Docker Compose变量插值致配置文件无效，端口配置报错

配置了如下docker-compose.yml及.env.local文件，执行docker-compose start时收到错误提示：services.myapp_db.ports包含无效类型，应为数字或对象。

docker-compose.yml配置：

version: "3.8"

services:
  myapp_db:
    image: mysql:5.8
    restart: unless-stopped
    env_file: ./.env.local
    environment:
      - MYSQL_ROOT_PASSWORD=$MYSQLDB_ROOT_PASSWORD
      - MYSQL_DATABASE=$MYSQLDB_DATABASE
    ports:
      - $MYSQLDB_LOCAL_PORT:$MYSQLDB_DOCKER_PORT
    volumes:
      - db:/var/lib/mysql

volumes:
  db:

.env.local配置：

MYSQLDB_USER=root
MYSQLDB_ROOT_PASSWORD=123456
MYSQLDB_DATABASE=myapp_db_local
MYSQLDB_LOCAL_PORT=3307
MYSQLDB_DOCKER_PORT=3306

1. 环境变量解析格式问题：docker-compose对环境变量的标准引用格式是${变量名}，直接用$变量名可能导致变量未被正确解析，使ports字段变成非预期的字符串类型，触发类型校验错误。
2. 镜像版本错误：MySQL官方没有mysql:5.8这个版本，镜像不存在会导致配置加载异常，间接引发解析问题。
3. 冗余配置干扰：已经通过env_file加载了环境变量，environment里用$变量名重复配置属于冗余操作，反而可能增加解析失败的概率。

1. 修正镜像版本：将image: mysql:5.8替换为官方存在的版本，比如mysql:5.7或mysql:8.0。
2. 规范环境变量引用格式：把ports字段的变量引用改成标准格式：

   ports:
     - "${MYSQLDB_LOCAL_PORT}:${MYSQLDB_DOCKER_PORT}"
   

3. 简化环境变量配置：去掉environment里的冗余配置，直接依赖env_file加载变量：

   environment:
     - MYSQL_ROOT_PASSWORD
     - MYSQL_DATABASE
   

4. 验证配置有效性：执行docker-compose config命令，检查输出中ports字段是否显示为3307:3306的正确格式，确认配置解析无误后再启动服务。

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