Docker容器内无法创建目录：Linux服务器权限问题求助

看起来你遇到的是典型的跨环境Docker权限差异问题——Mac的Docker Desktop会自动处理宿主与容器的用户UID/GID映射，所以本地运行顺畅，但Linux服务器上需要手动对齐用户权限，才能让容器内的PHP进程正常读写挂载的代码目录。结合你给出的docker-compose.yml片段，我给你一套具体的解决步骤：

1. 先确认宿主服务器的用户UID/GID #

在Linux服务器终端执行以下命令，获取当前用户的UID和GID：

id -u && id -g

通常输出是1000和1000（大部分Linux发行版的默认普通用户配置），记下来这两个数值。

2. 修改PHP-FPM的Dockerfile #

打开./docker/fpm/Dockerfile，添加与宿主匹配的用户创建逻辑，确保容器内的PHP进程用这个用户运行：

如果你的基础镜像是Alpine系：

FROM php:fpm-alpine

# 替换成你刚才查到的UID和GID
ARG UID=1000
ARG GID=1000

RUN addgroup -g ${GID} appuser && adduser -u ${UID} -G appuser -s /bin/sh -D appuser

# 提前创建Symfony需要写入的目录并设置权限
USER root
RUN mkdir -p /var/www/app/var /var/www/app/public/uploads \
    && chown -R appuser:appuser /var/www/app/var /var/www/app/public/uploads
USER appuser

如果是Debian/Ubuntu系的基础镜像：

FROM php:fpm

ARG UID=1000
ARG GID=1000

RUN groupadd -g ${GID} appuser && useradd -u ${UID} -g appuser -m appuser

# 提前创建Symfony需要写入的目录并设置权限
USER root
RUN mkdir -p /var/www/app/var /var/www/app/public/uploads \
    && chown -R appuser:appuser /var/www/app/var /var/www/app/public/uploads
USER appuser

3. 完善docker-compose.yml配置 #

修正你原来的配置（比如volumes定义的小问题），同时支持动态传递宿主UID/GID：

version: '3'
volumes:
  db_data:  # 用命名卷存储MySQL数据，比宿主挂载更稳定，避免权限问题

services:
  db:
    image: mysql
    volumes:
      - db_data:/var/lib/mysql
    environment:
      MYSQL_ROOT_PASSWORD: ${DATABASE_ROOT_PASS}
      MYSQL_DATABASE: ${DATABASE_NAME}
      MYSQL_USER: ${DATABASE_USER}
      MYSQL_PASSWORD: ${DATABASE_PASS}

  php:
    build: 
      context: ./docker/fpm
      args:
        UID: ${UID:-1000}
        GID: ${GID:-1000}
    volumes:
      - ./:/var/www/app
    environment:
      - APP_ENV=${APP_ENV:-prod}

  nginx:
    build: ./docker/nginx
    volumes:
      - ./:/var/www/app
    ports:
      - "80:80"
    depends_on:
      - php

4. 修复宿主目录权限并重新构建 #

在Linux服务器上，先确保宿主代码目录的权限与容器用户一致：

sudo chown -R $(id -u):$(id -g) ./

然后重新构建PHP服务并启动容器：

docker-compose build php
docker-compose up -d

为什么Mac上没问题？ #

Mac的Docker Desktop在挂载宿主目录时，会自动将宿主的用户UID/GID映射到容器内的root或匹配用户，绕过了Linux上严格的文件权限校验，所以不会出现权限拒绝的问题。

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