Label Studio项目运行时报错ModuleNotFoundError的解决方案

问题背景

在使用Label Studio项目时，执行python3 manage.py runserver命令启动服务时，系统报错ModuleNotFoundError: No module named 'rest_framework_simplejwt'。这个错误表明Python环境中缺少了djangorestframework-simplejwt这个关键依赖包。

问题分析

这个错误通常发生在以下几种情况下：

1. 依赖包确实没有安装
2. 依赖包安装在了错误的Python环境中
3. 多个Python环境导致包管理混乱
4. 虚拟环境未正确激活

详细解决方案

检查依赖包安装情况

首先需要确认djangorestframework-simplejwt是否已正确安装。可以通过以下命令检查：

pip freeze | grep djangorestframework-simplejwt

如果没有任何输出，说明该包确实没有安装。

正确安装依赖包

如果确认包未安装，可以使用以下命令安装：

pip install djangorestframework-simplejwt

如果之前安装过但仍有问题，建议先卸载再重新安装：

pip uninstall rest_framework_simplejwt djangorestframework-simplejwt
pip install djangorestframework-simplejwt

检查Python环境

确保你正在使用正确的Python环境运行Label Studio。特别是：

1. 如果你使用了虚拟环境，请确保已激活
2. 检查which python3和which pip是否指向同一个Python安装目录

验证安装结果

安装完成后，可以通过以下方式验证：

pip list | grep djangorestframework-simplejwt

应该能看到类似"djangorestframework-simplejwt==[版本号]"的输出。

预防措施

为了避免类似问题再次发生，建议：

1. 使用requirements.txt或Pipfile明确管理项目依赖
2. 始终在虚拟环境中开发和运行项目
3. 在部署前使用pip check命令验证依赖关系

总结

Label Studio项目依赖djangorestframework-simplejwt包来实现JWT认证功能。当遇到ModuleNotFoundError时，通常只需正确安装该包即可解决问题。关键在于确保包安装在了运行Label Studio的同一个Python环境中。通过上述步骤，大多数情况下都能顺利解决这个依赖问题。