Laravel环境Apache镜像Dockerfile文件所有者配置错误排查求助

我在搭建Laravel Docker环境时遇到Linux文件所有者匹配问题，参考的解决方案基于Debian镜像，但我使用的是php:7.3-apache镜像。添加用户创建相关代码后构建报错，以下是我的Dockerfile和docker-compose.yml文件，请求排查问题。

# Dockerfile 

FROM php:7.3-apache

COPY ./000-default.conf /etc/apache2/sites-available/000-default.conf

COPY --from=composer:2.0 /usr/bin/composer /usr/bin/composer

RUN apt-get update  \
    && apt-get -y install \
    git \
    zip \
    unzip \
    vim \
    && docker-php-ext-install pdo_mysql bcmath mbstring \
    && a2enmod rewrite
    
WORKDIR /var/www/html

EXPOSE 80

# 我添加了以下代码，但执行报错
ARG uid
RUN useradd -G www-data,root -u $uid -d /home/devuser devuser
RUN mkdir -p /home/devuser/.composer && \
    chown -R devuser:devuser /home/devuser

# docker-compose.yml

version: '3'
services:
  backend:
    build:
      context: ./docker/php
      dockerfile: Dockerfile
    ports:
      - "80:80"
    volumes:
      - ./src/backend:/var/www/html
      # - /etc/group:/etc/group:ro
      # - /etc/user:/etc/user:ro
    depends_on:
      - db

  db:
    build:
      context: ./docker/mysql
      dockerfile: Dockerfile
    command: --default-authentication-plugin=mysql_native_password
    ports:
      - "3306:3306"
    volumes:
      - ./docker/mysql/data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=pass

问题排查与修复 #

核心问题点 #

1. UID参数未传递：Dockerfile中定义了ARG uid，但构建时未传入该参数，导致useradd命令因缺少合法UID值报错。
2. 用户家目录未自动创建：useradd未添加-m参数，手动创建目录可能出现权限时序问题。
3. Apache运行用户未切换：即便创建了新用户，Apache仍默认使用www-data运行，挂载目录的所有者不匹配问题依然存在。
4. 工作目录权限未配置：挂载的/var/www/html目录未提前设置所属用户，宿主机文件权限与容器内进程权限冲突。

修复后的Dockerfile #

# Dockerfile 
FROM php:7.3-apache

COPY ./000-default.conf /etc/apache2/sites-available/000-default.conf

COPY --from=composer:2.0 /usr/bin/composer /usr/bin/composer

RUN apt-get update  \
    && apt-get -y install \
    git \
    zip \
    unzip \
    vim \
    && docker-php-ext-install pdo_mysql bcmath mbstring \
    && a2enmod rewrite

# 设置默认UID为1000（适配多数宿主机普通用户）
ARG uid=1000
# 创建用户并自动生成家目录，加入www-data和root组
RUN useradd -G www-data,root -u $uid -m -d /home/devuser devuser
# 配置composer目录权限
RUN chown -R devuser:devuser /home/devuser/.composer

# 修改Apache运行用户为devuser
RUN echo "export APACHE_RUN_USER=devuser" >> /etc/apache2/envvars
RUN echo "export APACHE_RUN_GROUP=devuser" >> /etc/apache2/envvars

# 预设工作目录权限
RUN chown -R devuser:devuser /var/www/html

WORKDIR /var/www/html

EXPOSE 80

修复后的docker-compose.yml #

# docker-compose.yml
version: '3'
services:
  backend:
    build:
      context: ./docker/php
      dockerfile: Dockerfile
      # 自动传递宿主机当前用户UID，默认值1000
      args:
        - uid=${UID:-1000}
    ports:
      - "80:80"
    volumes:
      - ./src/backend:/var/www/html
    depends_on:
      - db

  db:
    build:
      context: ./docker/mysql
      dockerfile: Dockerfile
    command: --default-authentication-plugin=mysql_native_password
    ports:
      - "3306:3306"
    volumes:
      - ./docker/mysql/data:/var/lib/mysql
    environment:
      - MYSQL_ROOT_PASSWORD=pass

关键修复说明 #

• 自动传递UID：通过${UID:-1000}自动获取宿主机当前用户UID，确保容器内用户UID与宿主机一致，解决文件所有者匹配问题。
• 用户创建优化：useradd添加-m参数自动生成家目录，避免手动创建目录的权限问题。
• Apache用户切换：修改环境变量让Apache使用新创建的用户运行，确保进程权限与挂载文件权限匹配。
• 提前配置目录权限：构建时设置/var/www/html的所属用户，避免挂载后权限冲突。

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