Docker容器中安装PyYAML后仍无法导入yaml模块问题排查

• 错误的PYTHONPATH配置：你在Dockerfile里写的两行PYTHONPATH存在两个硬伤：一是第二行直接把pip日志里带版本号、括号的提示文本当成了目录路径，根本不是合法的文件系统路径；二是ENV的赋值是直接覆盖逻辑，第二行会把第一行配置的/home/GAN完全替换掉，根本起不到补充模块搜索路径的作用。
• 非必要的--user安装引发的路径错位：基础python镜像在构建阶段默认以root身份执行命令，你给wandb安装加的--user参数，会把包装到root用户专属的家目录（/root/.local）下。后续容器运行时，进程身份是UID 1270的普通用户，Python的模块搜索逻辑根本不会扫描root家目录下的包，自然会报找不到yaml的错误。
• 用户目录权限错位：因为运行用户的家目录配置不对，pip默认找不到当前用户对应的.local目录，错误地把安装根路径指向了不可写的/.local，才会出现权限拒绝的报错。

• 删掉Dockerfile里错误的PYTHONPATH配置行，尤其是带版本号括号的那行；如果确实需要把/home/GAN加入模块搜索路径，正确写法是ENV PYTHONPATH=/home/GAN:${PYTHONPATH}，保留系统默认的模块路径值，避免覆盖。
• 移除所有pip安装命令里的--user参数，把原来的RUN pip install wandb --user改成RUN pip install wandb。构建阶段的root身份本来就有全局安装包的权限，根本不需要走用户目录安装逻辑，从根源上避免不同用户之间的包路径隔离问题。
• 调整PyYAML的安装命令，直接装到全局路径：把原来的PyYAML安装行改成RUN pip install --no-cache-dir PyYAML==5.4.1，跳过缓存步骤，确保包被安装到所有用户都能访问的全局site-packages目录（/usr/local/lib/python3.9/site-packages），而不是root专属的用户目录。
• 权限兜底配置：如果容器启动时固定使用UID 1270的普通用户运行，可以在Dockerfile里提前创建匹配的用户目录结构，提前授权可写权限，避免pip找不到用户路径触发的权限报错。

• 构建完成启动容器后，先查看当前Python的模块搜索路径，执行python -c "import sys; print('\n'.join(sys.path))"，确认全局site-packages目录在搜索列表里。
• 执行python -c "import yaml; print(yaml.__version__)"，正常输出5.4.1版本号就代表导入成功。
• 执行pip freeze | grep -i pyyaml，确认包信息能被当前环境识别。

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