Windows环境执行docker compose pull安装Apache Superset报错求助

核心问题分析 #

报错services.superset.env_file.0 must be a string说明docker-compose.yml里的env_file配置格式不符合Docker Compose要求，大概率是Windows路径格式解析错误，导致配置项被识别为非字符串类型。

具体修复步骤 #

• 修正env文件路径格式
  打开项目根目录的docker-compose.yml，定位到superset服务下的env_file配置段，确保每个路径用字符串包裹，并且使用正斜杠（/）或转义反斜杠（\）：

  env_file:
    - "./docker/superset/superset_config.env"
  

  也可以直接写绝对路径（注意用正斜杠）：

  env_file:
    - "C:/superset/superset/docker/superset/superset_config.env"
  

• 确认env文件存在
  检查docker/superset/superset_config.env是否存在，若没有，复制同目录下的示例文件并重命名：

  copy docker\superset\superset_config.env.example docker\superset\superset_config.env
  

• 消除环境变量警告（可选）
  CYPRESS_CONFIG和SCARF_ANALYTICS的警告不影响核心功能，若想消除，在项目根目录的.env文件中添加：

  CYPRESS_CONFIG=
  SCARF_ANALYTICS=false
  

• 重新执行Docker命令
  清理旧配置后重启服务：

  docker compose down -v
  docker compose pull
  docker compose up -d
  

额外注意事项 #

• 优先用PowerShell或WSL2终端执行命令，避免CMD的路径解析问题。
• 若使用WSL2后端，确保Docker Desktop的WSL集成已开启，减少文件系统兼容性问题。

内容的提问来源于stack exchange，提问作者Jose Luiz Durigon