Django项目集成GraphQL时启动服务报错ModuleNotFoundError: No module named 'graphene_django'的解决方案求助

看起来你遇到的是典型的Python环境包路径不匹配问题，别着急，我们一步步来排查解决：

• 确认Python解释器与pip的对应关系
  Mac上很容易出现系统Python和用户安装的Python版本混淆的情况，先检查当前终端使用的Python和pip是否属于同一个环境：

  • 查看Python路径：which python3
  • 查看pip路径：which pip3
    如果两个路径不一致，说明你用pip安装的包不在当前Python解释器的环境中，此时应该使用python3 -m pip install graphene-django来安装，确保包被安装到当前Python对应的site-packages目录下。

• 检查INSTALLED_APPS的拼写
  仔细看你的错误日志，报错信息是No module named 'graphene-django'（横杠连接），但graphene-django在Django配置中的正确写法是graphene_django（下划线连接）。请确认你的settings.py中配置正确：

  INSTALLED_APPS = [
      # 其他默认应用
      'graphene_django',
  ]
  

  Python模块名不允许包含横杠，若不小心写成graphene-django会直接导致导入失败。

• 验证虚拟环境的激活状态
  如果你使用了虚拟环境，务必确认它处于激活状态：

  • 激活虚拟环境：source env/bin/activate（Mac/Linux系统）
  • 激活成功后，终端前缀会显示(env)，此时再执行pip list确认graphene-django存在，随后运行python manage.py runserver启动服务。

• 强制重新安装graphene-django
  有时候包安装可能存在损坏或不完整的情况，可尝试卸载后重新安装：

  pip uninstall graphene-django -y
  pip install graphene-django==3.0.0  # 与你当前使用的版本保持一致
  

• 检查IDE的Python解释器配置（若使用IDE开发）
  如果你用PyCharm、VSCode等IDE开发，可能IDE选择的Python解释器并非你安装graphene-django的环境：

  • VSCode：点击左下角的Python版本选择器，切换到对应的虚拟环境或正确的Python解释器；
  • PyCharm：通过File > Settings > Project: 你的项目名 > Python Interpreter选择对应环境。

按照以上步骤逐一排查，应该就能解决问题啦，要是还有疑问可以随时反馈~

备注：内容来源于stack exchange，提问作者Usha Rani