如何修复Flask Dockerfile中的'WORKDIR /code'错误？

问题背景 #

我从Docker官方文档获取了以下Dockerfile代码：

FROM python:3.7-alpine
WORKDIR /code
ENV FLASK_APP=app.py
ENV FLASK_RUN_HOST=0.0.0.0
RUN apk add --no-cache gcc musl-dev linux-headers
# Install app dependencies
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
# Bundle app source
EXPOSE 5000
COPY . .
CMD ["flask", "run"]

构建时触发如下错误：

> [2/6] WORKDIR /code:
------
Dockerfile:3
--------------------
   1 |     FROM python:3.11-alpine
   2 |
   3 | >>> WORKDIR /code
   4 |     ENV FLASK_APP=app.py
   5 |     ENV FLASK_RUN_HOST=0.0.0.0
--------------------
ERROR: failed to solve: error creating overlay mount to /var/lib/docker/overlay2/kl5w9si1xv311f5b73j521acw/merged: too many levels of symbolic links

项目包含app.py、requirements.txt和Dockerfile三个文件。

解决方案 #

1. 排查本地目录的符号链接问题 #

这个错误核心是Docker的overlay2存储驱动与本地文件系统的符号链接冲突：

• 检查Dockerfile所在目录及其父目录，删除循环符号链接或层级过深的符号链接
• 不要将构建目录放在通过符号链接挂载的路径下（比如跨系统共享目录、自定义软链接指向的文件夹）

2. 更换WORKDIR路径 #

如果无法调整本地目录结构，可修改Dockerfile中的WORKDIR路径，规避潜在的路径冲突：

# 替换原WORKDIR配置
WORKDIR /app

# 同步调整后续COPY路径
COPY requirements.txt /app/requirements.txt
COPY . /app/

3. 重置Docker存储驱动（极端场景） #

若上述方法无效，可重置Docker的overlay2存储（注意：此操作会删除所有本地镜像和容器）：

sudo systemctl stop docker
sudo rm -rf /var/lib/docker/overlay2
sudo systemctl start docker

4. 统一基础镜像版本 #

错误日志中显示实际使用的是python:3.11-alpine，但Dockerfile中写的是python:3.7-alpine，统一版本避免潜在兼容问题：

# 保持版本一致，二选一即可
FROM python:3.11-alpine
# 或者
FROM python:3.7-alpine

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