执行docker-compose up -d时报DOCKER_WWWROOT未设置或目录不存在错误

1. 排查sudo导致的环境变量丢失问题 #

Ubuntu默认sudo命令会重置绝大多数环境变量以保障系统安全，普通用户会话下export的变量默认不会被sudo继承，这是该问题最常见的诱因。

• 验证方式：执行 sudo echo $***DOCKER_WWWROOT，如果输出为空即可确认是该问题
• 解决方案：
  • 单次临时生效：执行命令时直接传递变量 sudo ***DOCKER_WWWROOT=/path/to/myproject docker-compose up -d
  • 永久生效：将当前用户加入docker用户组，后续无需加sudo执行docker相关命令：

    sudo usermod -aG docker $USER
    newgrp docker
    

    配置完成后直接执行 docker-compose up -d 即可正常读取环境变量。

2. 排查环境变量未持久化问题 #

直接在终端执行export的变量仅对当前终端会话生效，切换终端标签、重启终端、切换用户后配置都会失效。

• 解决方案：
  • 临时使用：每次执行docker-compose前先重新执行一遍export命令
  • 持久化配置：将变量写入当前用户的bash配置文件，每次登录自动加载：

    echo 'export ***DOCKER_WWWROOT=/path/to/myproject' >> ~/.bashrc
    source ~/.bashrc
    

3. 排查compose配置文件优先级问题 #

docker-compose默认优先读取执行命令目录下的.env文件中的变量，如果你在docker-compose.yml中额外指定了env_file配置项，也会优先读取对应文件的变量，优先级高于系统环境变量。

• 解决方案：检查执行目录下的.env文件和compose.yml中指定的env_file文件，要么删除对应文件中为空的***DOCKER_WWWROOT配置，要么直接将你的路径写入这些配置文件中。

4. 排查目录权限问题 #

即使路径真实存在，如果docker运行时使用的用户没有该目录的读和执行权限，也会触发该报错。

• 解决方案：执行 chmod -R 755 /path/to/myproject 给目录开放最小必要权限，也可以根据实际需求将目录所有者调整为docker运行使用的用户。

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