WSL2中Docker运行正常但容器构建失败，求解决方法

1. 构建上下文权限冲突（WSL2与Windows共享目录） #

• 成因：若项目放在Windows挂载的目录（如/mnt/c下），WSL2的权限映射机制会导致容器构建时无法读取文件、执行脚本，触发权限报错。
• 解决办法：
  • 将项目迁移至WSL2原生目录（如~/lambda-projects），避免跨系统权限问题。
  • 若需保留在Windows目录，编辑WSL配置文件/etc/wsl.conf，添加以下内容：

    [automount]
    enabled = true
    options = "metadata,umask=0022,fmask=0022"
    mountFsTab = false
    

    执行wsl --shutdown重启WSL后生效。

2. Lambda基础镜像拉取失败 #

• 成因：网络问题无法访问Amazon ECR镜像仓库，或Dockerfile中FROM指令的镜像标签错误。
• 解决办法：
  • 检查FROM指令正确性，比如Python 3.11的Lambda官方镜像为public.ecr.aws/lambda/python:3.11，确保标签与你的运行环境匹配。
  • 网络问题可配置Docker国内镜像加速，或在WSL中设置代理（需确保代理可访问AWS ECR）。

3. Docker服务未正常运行 #

• 成因：WSL2中的Docker服务未启动，或与Windows Docker Desktop存在资源冲突。
• 解决办法：
  • 若使用WSL原生Docker，执行sudo systemctl start docker启动服务，sudo systemctl enable docker设置开机自启。
  • 若同时安装了Windows Docker Desktop，在Docker Desktop设置中启用对应WSL发行版的集成，或关闭Windows Docker服务后使用WSL原生Docker。

4. 依赖安装失败 #

• 成因：Dockerfile中安装系统依赖/Python包时，默认镜像源访问慢或不存在对应包。
• 解决办法：
  • 系统依赖：更换Ubuntu国内源，在Dockerfile中添加：

    RUN sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
    RUN apt-get update && apt-get install -y [你的依赖包名]
    

  • Python包：在pip install命令中添加国内PyPI源，如pip install --index-url https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt。

5. Lambda入口配置错误 #

• 成因：Dockerfile中CMD/ENTRYPOINT指令未符合Lambda要求，导致构建后容器无法识别函数入口。
• 解决办法：确认指令格式正确，比如Python函数需指定CMD ["app.lambda_handler"]，其中app是你的Python文件名，lambda_handler是Lambda触发的函数名。

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