多Python环境下运行脚本报ModuleNotFoundError找不到netfilterqueue模块如何修复

核心问题根因 #

这类“pip提示安装成功、交互模式可加载、实际运行脚本报找不到模块”的场景，绝大多数是多Python环境下的路径错配导致，结合你提到的实际场景，常见诱因包括：

• pip/pip3默认指向的解释器，和你实际运行脚本的解释器不是同一个
• pyenv管理的Python环境未正确激活，执行命令时跳回系统默认的Python 3.9/2.7路径
• 编译C扩展时链接了错版本的Python开发包（你的依赖输出显示python-dev被自动替换成了Python2的开发包，完全不匹配Python3环境）
• 脚本开头的shebang行硬指定了其他路径的解释器，绕过了你激活的pyenv环境

分步修复操作 #

• 第一步：锁定实际使用的Python解释器路径，避免错配
  在你要运行脚本的终端里执行两条命令，拿到准确的解释器绝对路径：

which python3
python3 -c "import sys; print(sys.executable)"

后续所有pip操作都不要直接用全局pip/pip3，改用对应解释器的模块调用方式装包：<刚才拿到的解释器绝对路径> -m pip install netfilterqueue，这种方式可以100%保证包装到当前使用的解释器的site-packages路径下，不会出现“pip说装了但Python找不到”的错位问题。

• 第二步：修正pyenv环境的激活逻辑
  进入需要运行脚本的工作目录，执行 pyenv local <你实际安装的Python3.6版本号>，把当前目录的Python版本硬绑定到3.6，避免切目录、开新终端时环境跳回系统默认版本。
  执行 echo $PATH 检查pyenv的shim目录是不是排在系统Python路径的最前面，顺序不对的话pyenv激活的环境不会生效。
• 第三步：修正系统依赖的版本错位
  你之前的依赖安装输出显示python-dev被自动替换成了Python2.7的开发包，用这个包编译Python3的C扩展会直接失败。需要先安装和目标Python版本匹配的开发依赖：

sudo apt install build-essential libnetfilter-queue-dev python3-dev python3.6-dev

再把之前错装的无效netfilterqueue包卸载干净：<目标解释器路径> -m pip uninstall netfilterqueue，再重新执行安装命令。

• 第四步：排查脚本本身的解释器调用问题
  检查脚本第一行的shebang声明，如果是#!/usr/bin/python3这种硬指定系统Python路径的写法，哪怕你在终端激活了pyenv的3.6环境，直接执行./your_script.py时还是会走系统Python的路径，自然找不到装在pyenv环境里的包。跑脚本时直接用<目标解释器路径> your_script.py的显式调用方式，或者把shebang路径改成和实际装包的解释器路径一致。
• 第五步：对应原系统和Kali live环境的差异排查
  你之前添加的第三方测试源很可能替换了系统自带的libnetfilter-queue-dev、Python开发包的默认版本，导致编译出的二进制扩展和系统动态库不兼容。可以临时注释掉第三方源，恢复Kali官方源的默认包版本后重新安装依赖，即可复现Kali live环境下的可用状态。
  之前系统提示可自动移除的冗余开发包（libpython3-dev、python3.9-dev等），可以先执行sudo apt autoremove清理，避免编译时链接到错版本的动态库。

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