Alpine Docker镜像创建UID=1000用户报错，如何正确操作？

你的问题出在对Alpine adduser命令的参数理解错误：-g参数不是指定用户所属组的GID，而是用来设置用户的注释信息（gecos字段）。这导致你的命令没有关联之前创建的sail组，反而触发了系统内部的UID冲突检测问题。

正确的Dockerfile写法 #

FROM alpine:3.16

# 创建GID=1000的sail组
RUN addgroup -g 1000 sail

# 创建UID=1000的sail用户，关联到sail组，同时禁用密码设置
RUN adduser -D -u 1000 -G sail sail

参数说明 #

• -D：不设置用户密码（容器环境中通常不需要密码登录）
• -u 1000：指定用户UID为1000
• -G sail：将用户添加到sail组（对应之前创建的GID=1000的组）

额外排查建议 #

如果仍遇到UID冲突，可以在构建时加上--no-cache参数清理构建缓存，避免缓存中的旧镜像层干扰：

docker build --no-cache -t your-image-name .

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