部署含MySQL的多容器Web应用时出现卷规格无效错误

核心原因 #

错误提示明确显示卷规格为:/var/lib/mysql，说明环境变量${WEBAPP_STORAGE_HOME}未被正确解析，实际为空值，导致挂载路径左侧缺失，Docker无法识别这种无效的卷挂载格式。

排查与解决步骤 #

• 验证环境变量实际生效状态：
  先通过命令确认变量值是否正确输出：Linux/macOS环境执行echo ${WEBAPP_STORAGE_HOME}，Windows环境执行echo %WEBAPP_STORAGE_HOME%，确保输出是预期的路径而非空值。
• 改用绝对路径测试：
  临时将卷挂载行替换为绝对路径，比如- /真实存在的本地目录/mysql-data:/var/lib/mysql，如果部署成功，即可确认是环境变量解析的问题。
• 检查部署平台的变量配置规则：
  若在云平台（如Azure App Service、AWS ECS）部署，需确认平台是否支持在Docker Compose中使用自定义环境变量，部分平台要求变量在专属配置面板设置，且需重启应用使变量生效。
• 核对变量名拼写：
  确认WEBAPP_STORAGE_HOME拼写完全正确，大小写敏感环境（如Linux）中，大小写错误会导致变量无法被识别。

替代方案 #

如果主机路径挂载存在兼容性问题，可改用Docker命名卷，避免路径依赖：

version: '3.8'
networks:
    restapi:
volumes:
    mysql-data:  # 定义命名卷
services:
    api:
        container_name: api
        image: <custom-image>:latest
        environment:
            ...
        depends_on:
            - mysql-server
        networks:
            - restapi
        ports:
            - "8080:80"
    mysql-server:
        container_name: mysql-server
        image: mysql:latest
        environment:
            ...
        networks:
            - restapi
        ports:
            - "8082:3306"
        volumes:
            - mysql-data:/var/lib/mysql  # 使用命名卷

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