使用Djongo连接MongoDB时Django数据库错误的解决方法

问题核心 #

注册用户时触发django.db.utils.DatabaseError，根源是MongoDB中loginapi_user集合的email字段存在唯一索引，提交的邮箱m@gmail.com已存在，触发E11000重复键冲突。

具体解决步骤 #

1. 清理MongoDB中的重复数据 #

打开MongoDB Shell，连接目标数据库并处理重复记录：

# 连接MongoDB
mongo
# 切换到你的项目数据库（示例为PP1）
use PP1
# 查询重复邮箱的记录
db.loginapi_user.find({email: "m@gmail.com"})
# 删除重复记录（按需保留有效数据）
db.loginapi_user.deleteOne({email: "m@gmail.com"})

2. 检查并修复MongoDB的唯一索引 #

若重置数据库后索引仍残留，手动清理后重新生成：

# 查看集合所有索引
db.loginapi_user.getIndexes()
# 删除指定的email唯一索引（索引名通常为email_1）
db.loginapi_user.dropIndex("email_1")

如果业务需要邮箱唯一约束，重新运行Django迁移重建索引：

python manage.py makemigrations
python manage.py migrate

3. 在序列化器中添加前置校验 #

在注册序列化器中提前校验邮箱唯一性，避免触发数据库错误：

# loginapi/serializers.py
from rest_framework import serializers
from .models import User

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['name', 'email', 'password']

    def validate_email(self, value):
        if User.objects.filter(email=value).exists():
            raise serializers.ValidationError("该邮箱已被注册")
        return value

4. 捕获并处理数据库错误（可选） #

在视图中解析Djongo抛出的错误，返回用户友好提示：

# loginapi/views.py
from django.db.utils import DatabaseError
from pymongo.errors import BulkWriteError
from rest_framework.response import Response
from rest_framework import status
from rest_framework.views import APIView
from .serializers import UserSerializer

class RegisterView(APIView):
    def post(self, request):
        serializer = UserSerializer(data=request.data)
        if serializer.is_valid():
            try:
                serializer.save()
                return Response(serializer.data, status=status.HTTP_201_CREATED)
            except DatabaseError as e:
                # 解析MongoDB重复键错误
                cause = e.__cause__.__cause__ if hasattr(e.__cause__, '__cause__') else None
                if isinstance(cause, BulkWriteError):
                    for err in cause.details['writeErrors']:
                        if err['code'] == 11000:
                            return Response({"error": "该邮箱已被注册"}, status=status.HTTP_400_BAD_REQUEST)
                return Response({"error": "注册失败"}, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

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