Windows下Rails项目Dev Container非root用户无法保存文件求助

核心原因 #

容器内自定义用户myUser的UID/GID和WSL2宿主环境中当前用户的UID/GID不匹配，导致挂载到容器里的项目目录及文件的所有者是宿主用户（WSL2默认用户UID通常为1000），而容器内myUser的UID不同，没有写入权限，最终触发保存文件失败的错误。

解决方法 #

方法1：让容器内用户UID与WSL2宿主用户保持一致 #

方式A：硬编码指定UID为1000（适配多数WSL2场景）

修改Dockerfile，创建用户时直接指定UID/GID为WSL2默认值：

# 创建myUser并指定UID=1000，GID=1000
RUN useradd -m -u 1000 -g 1000 myUser
# 将项目目录权限赋予myUser
RUN chown -R myUser:myUser /workspace

方式B：构建时动态传入宿主UID/GID（更灵活）

1. 更新Dockerfile，支持构建参数：

ARG USER_UID=1000
ARG USER_GID=1000

# 创建用户组（按需）
RUN groupadd -g $USER_GID myUserGroup
# 创建用户并绑定指定UID/GID
RUN useradd -m -u $USER_UID -g $USER_GID myUser
# 赋予项目目录权限
RUN chown -R myUser:myUser /workspace

2. 在compose.yaml中传递构建参数：

services:
  app:
    build:
      context: .
      args:
        USER_UID: ${UID:-1000}
        USER_GID: ${GID:-1000}
    user: myUser
    volumes:
      - .:/workspace

3. 在WSL2终端执行构建命令，自动传入当前用户的UID/GID：

UID=$(id -u) GID=$(id -g) docker-compose build

方法2：通过devcontainer.json自动同步权限 #

修改.devcontainer/devcontainer.json，配置VSCode自动同步宿主用户UID到容器：

{
  "remoteUser": "myUser",
  "updateRemoteUserUID": true,
  "mounts": [
    "source=/etc/passwd,target=/etc/passwd,type=bind,readonly",
    "source=/etc/group,target=/etc/group,type=bind,readonly"
  ]
}

此配置会让VSDevContainer自动调整容器内myUser的UID，与WSL2宿主用户保持一致，同时绑定宿主的用户组文件，避免权限冲突。

方法3：修复现有容器的目录权限 #

若已构建容器不想重新构建，可通过root用户进入容器调整权限：

# 以root身份进入容器
docker exec -u root -it <你的容器名称/ID> bash
# 修改项目目录所有者为myUser
chown -R myUser:myUser /workspace

验证方法 #

进入容器后执行以下命令，确认UID匹配：

# 查看myUser的UID
id -u myUser
# 查看项目目录的所有者UID
stat -c "%u" /workspace

两者UID一致则权限配置正确。

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