Docker中激活虚拟环境后Poetry无法识别依赖的原因解析

核心原因：Docker的shell会话隔离 #

Docker的每一条RUN、CMD、ENTRYPOINT指令都运行在独立的shell会话中：

• 你在某条RUN指令里执行source venv/bin/activate激活虚拟环境，这个操作仅对当前RUN的会话生效。后续启动应用的CMD/ENTRYPOINT会开启全新shell，之前激活虚拟环境时设置的PATH、VIRTUAL_ENV等环境变量不会被继承。
• 虽然poetry install确实把依赖装到了虚拟环境里，但启动应用时系统调用的是全局Python环境，自然找不到虚拟环境内的依赖包。

为什么禁用虚拟环境能解决问题 #

当设置poetry config virtualenvs.create false后，Poetry会直接把依赖安装到容器的全局Python环境中，而非创建独立虚拟环境。这种情况下，无论后续用哪个shell会话执行应用，Python都能直接读取到已安装的依赖，不需要额外的虚拟环境激活操作。

补充：如果非要用虚拟环境的替代方案 #

如果坚持在Docker中使用Poetry虚拟环境，有两种可行方式：

• 将激活虚拟环境与启动应用的命令合并到同一条CMD/ENTRYPOINT中，确保在同一个shell会话执行，示例：

  CMD ["sh", "-c", "source /path/to/venv/bin/activate && python your_app.py"]
  

• 直接调用虚拟环境内的Python解释器路径启动应用，示例：

  CMD ["/path/to/venv/bin/python", "your_app.py"]
  

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