Azure Web App多容器部署报错：Bind mount需以${WEBAPP_STORAGE_HOME}开头

错误原因 #

Azure Web App的多容器部署规则明确要求：绑定挂载卷必须以${WEBAPP_STORAGE_HOME}开头，你当前配置中使用的本地相对路径（如./api:/backend）不符合平台限制，导致配置解析失败。

解决方案 #

1. 移除本地开发用的volumes配置 #

Azure Web App托管环境不支持挂载本地代码目录，且生产部署时代码应已打包进镜像，无需实时同步修改。修改后的docker-compose.yml如下：

version: '3'
services:
  api:
    build: api
    image: your-acr-registry.azurecr.io/containergroup:app-flask
    command: ["flask", "run", "--host=0.0.0.0"]
    environment:
      - FLASK_ENV=production
      - FLASK_APP=flask_app.py
    ports:
      - "5000:5000"
  client:
    build: client
    image: your-acr-registry.azurecr.io/containergroup:app-react
    command: ["npm", "start"]
    environment:
      - NODE_ENV=production
    ports:
      - '3000:3000'
    depends_on:
      - api

注意：将your-acr-registry替换为你实际的Azure容器注册表（ACR）名称，确保镜像路径合法可访问。

2. 调整环境变量（可选但推荐） #

将开发环境变量FLASK_ENV=development和NODE_ENV=development改为production，避免开发调试特性在生产环境中暴露安全风险。

3. 确认镜像已推送至ACR #

部署前需将构建完成的Flask、React镜像推送到你的Azure容器注册表，否则Azure Web App无法拉取镜像完成部署流程。

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