Docker容器内执行cd /var/www失败，求助解决思路

可能的原因及解决思路 #

1. 本地挂载卷覆盖了容器内的/var/www

如果启动容器时用了-v参数或在docker-compose.yml中配置了挂载本地目录到/var/www，可能触发两种异常：

• 本地目录不存在，容器内/var/www会被自动创建但为空，若本地目录权限异常，会导致容器内对应目录无法访问
• 本地目录权限不足，容器内/var/www的权限被同步为本地的限制权限，导致执行脚本的用户无法进入目录

解决：

• 先移除挂载命令，直接启动容器测试：docker run --rm your-image-name，如果不再报错，说明是挂载的问题
• 确保本地挂载目录存在，并且设置匹配容器用户的权限：chown -R 1000:1000 /path/to/local/laravel（对应Dockerfile中创建的www用户UID/GID）

2. 脚本执行用户无/var/www访问权限

虽然/var/www权限是drwxr-xr-x（其他用户有读和执行权限），但如果启动容器时指定了--user www切换到非root用户，且本地挂载的目录权限未对www用户开放，就会出现无法cd的情况。

解决：

• 在Dockerfile中添加命令，确保/var/www的归属为www用户：

  RUN chown -R www:www /var/www
  

• 或者在启动容器时不指定--user参数，默认用root执行脚本（Laravel运行时的权限问题可通过supervisor配置让php-fpm用www用户运行）

3. run.sh脚本存在Windows换行符（CRLF）

如果脚本是在Windows环境下编辑的，换行符会是CRLF，而Linux容器只能识别LF，这会导致cd命令被解析为cd^M /var/www，系统无法识别该路径。

解决：

• 将脚本转换为LF换行符：用编辑器（如VS Code）设置换行符为LF，或者在Dockerfile中添加转换步骤：

  RUN apt-get update && apt-get install -y dos2unix && dos2unix /run.sh
  

• 用git管理代码时，设置autocrlf=input避免自动转换换行符

4. 添加调试信息定位问题

在run.sh开头添加调试命令，明确执行脚本时的上下文：

#!/bin/sh
# 调试信息
whoami
ls -ld /var/www
pwd

cd /var/www || { echo "Failed to cd to /var/www"; exit 1; }

php artisan cache:clear
php artisan route:cache

/usr/bin/supervisord -c /etc/supervisord.conf

启动容器后查看输出，就能知道当前用户是谁、/var/www是否存在、当前工作目录是什么，快速定位问题。

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