Docker容器内通过subprocess安装Python自定义包后无法导入问题排查

• Python进程导入路径缓存未刷新：当前运行的Python进程的sys.path是进程启动时完成初始化的，你通过subprocess执行安装操作时，新写入的包路径不会自动同步到已经启动的Python进程中，不管是pkgutil.iter_modules()还是import语句，都只会读取当前进程缓存的路径列表，自然扫描不到也无法导入新安装的包。
• setup.py develop的路径机制未生效：develop模式会将项目路径写入site-packages目录下的easy-install.pth配置文件，但该文件仅会在Python进程启动时被读取，运行过程中安装的包不会触发进程主动重读该配置，新增的路径自然不会生效。就算换成pip安装也会触发同样的问题，因为pip的安装逻辑同样依赖进程启动时加载的路径配置。
• Docker用户权限不匹配：如果ENTRYPOINT运行时的用户和执行安装操作的用户不是同一个，pip/setup.py默认会将包安装到当前用户的私有site-packages目录，不同用户的包路径不互通，也会导致找不到包。
• 压缩包目录结构异常：你用os.path.commonprefix提取的包根目录可能不准确，或者压缩包内的顶层目录缺少__init__.py文件，不符合Python包的识别规则，也会导致导入失败。

• 安装完成后主动刷新路径配置，加入以下代码即可重读所有路径配置：

import sys
import site
from importlib import reload
reload(site)

• 拆分执行逻辑：不要在同一个Python进程内完成「安装包+导入包」的操作，先执行独立的安装脚本，安装完成后用exec启动新的Python进程执行业务逻辑，新进程启动时会自动加载全量路径配置，不会存在缓存问题。
• 手动添加包路径：如果嫌麻烦可以直接把解压后的包目录手动加入sys.path，无需等待安装逻辑的路径同步，示例代码如下：

sys.path.append('/' + package_main_directory)

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