PHP Docker环境访问上传目录图片提示403权限错误如何解决

• Dockerfile权限配置错误：原配置中RUN chown -R 777 /var/*属于命令误用，chown用于修改文件所有者，传入777会将文件所有者改为不存在的777用户，完全达不到修改权限的效果；且镜像构建阶段修改的/var目录权限，会被后续docker-compose挂载的本地目录权限完全覆盖，无法生效。
• 宿主与容器用户UID不匹配：Debian系镜像中Apache运行用户www-data的默认UID为33、GID为33，而Ubuntu宿主下的项目目录是由普通用户（UID通常为1000）创建的，挂载后容器内的www-data用户没有权限读取本地uploads目录下的文件。
• 潜在的.htaccess规则冲突：vhost配置开启了AllowOverride All，如果uploads目录下存在错误的.htaccess规则（比如禁止访问静态资源、错误的重定向规则），也会触发403报错。

步骤1：修正Dockerfile配置 #

替换原有错误的权限配置行，调整后的完整Dockerfile如下：

FROM php:7.3.28-apache
RUN docker-php-ext-install mysqli

# 可选：开发环境下可将容器内www-data的UID改为与宿主普通用户一致（将1000替换为你本地执行id -u返回的数值）
# RUN usermod -u 1000 www-data && groupmod -g 1000 www-data

# 调整容器内web目录的基础权限
RUN chown -R www-data:www-data /var/www/html \
    && chmod -R 755 /var/www/html

RUN a2enmod rewrite
EXPOSE 80

步骤2：对齐宿主目录权限 #

在Ubuntu宿主的项目根目录执行以下命令，将uploads目录的所有者改为与容器内www-data匹配的UID/GID：

sudo chown -R 33:33 ./uploads

如果你在Dockerfile中修改了www-data的UID为本地用户的UID，则不需要执行上面的chown命令。

步骤3：排查.htaccess规则 #

检查项目根目录以及uploads目录下的.htaccess文件，删除禁止访问图片、拦截静态资源的错误规则，重点排查是否存在Deny from all、限制后缀访问的配置。

步骤4：重启服务验证 #

执行以下命令重新构建镜像并启动服务：

docker-compose down && docker-compose up -d --build

清理浏览器缓存后重新访问图片地址即可正常加载。如果仍有问题，可执行docker logs php_medix_uk查看Apache错误日志，定位具体报错原因。

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