Django集成MongoDB(Djongo)：自定义_id替代id遇问题求助

一、Model层：配置自动生成的_id，禁用默认id #

在models.py中使用Djongo提供的ObjectIdField作为主键，让MongoDB自动生成_id，同时禁用Django默认的自增id字段：

from djongo.models import Model, ObjectIdField

class YourModel(Model):
    _id = ObjectIdField(primary_key=True, default=None, editable=False)
    # 自定义业务字段，比如：
    title = models.CharField(max_length=100)
    content = models.TextField()

    class Meta:
        db_table = 'your_collection_name'

• primary_key=True：将_id设为主键，替代默认id
• default=None：让MongoDB自动生成ObjectId
• editable=False：禁止该字段在表单或序列化中被修改

二、Serializer层：返回_id并避免插入冲突 #

在serializers.py中显式包含_id字段，设置为只读，避免插入时要求传入该字段：

from rest_framework import serializers
from .models import YourModel

class YourModelSerializer(serializers.ModelSerializer):
    _id = serializers.CharField(read_only=True)

    class Meta:
        model = YourModel
        fields = ('_id', 'title', 'content')  # 明确列出字段，不要包含默认id

• read_only=True：确保序列化器仅返回_id，插入数据时不要求前端传入，避免“_id不能为空”错误

三、视图层：校验ObjectId格式 #

对单条数据的GET/PUT/DELETE请求，先校验传入的id参数是否为合法的ObjectId：

from bson.objectid import ObjectId, InvalidId
from rest_framework.views import APIView
from rest_framework.response import Response
from rest_framework import status
from .models import YourModel
from .serializers import YourModelSerializer

class YourModelDetailView(APIView):
    def get_valid_instance(self, pk):
        # 先校验ObjectId格式
        try:
            ObjectId(pk)
        except InvalidId:
            return (None, "无效的ObjectId格式", status.HTTP_400_BAD_REQUEST)
        # 再查询数据
        try:
            instance = YourModel.objects.get(pk=pk)
            return (instance, None, None)
        except YourModel.DoesNotExist:
            return (None, "数据不存在", status.HTTP_404_NOT_FOUND)

    def get(self, request, pk):
        instance, error, code = self.get_valid_instance(pk)
        if error:
            return Response({"error": error}, status=code)
        serializer = YourModelSerializer(instance)
        return Response(serializer.data)

    def put(self, request, pk):
        instance, error, code = self.get_valid_instance(pk)
        if error:
            return Response({"error": error}, status=code)
        serializer = YourModelSerializer(instance, data=request.data)
        if serializer.is_valid():
            serializer.save()
            return Response(serializer.data)
        return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)

    def delete(self, request, pk):
        instance, error, code = self.get_valid_instance(pk)
        if error:
            return Response({"error": error}, status=code)
        instance.delete()
        return Response(status=status.HTTP_204_NO_CONTENT)

• 用ObjectId(pk)捕获InvalidId异常，快速判断参数格式是否合法
• 区分“格式错误”和“数据不存在”两种错误场景，返回对应状态码

四、常见错误排查 #

1. “_id不能为空”：

   • 检查Model中_id的default是否设为None，editable是否为False
   • 确认Serializer中_id是read_only=True，不会强制要求传入

2. “主键相关”错误：

   • 确保Model中仅设置_id一个主键，不要保留默认的id字段
   • 验证settings.py中的数据库配置是否正确：

     DATABASES = {
         'default': {
             'ENGINE': 'djongo',
             'NAME': 'your_db_name',
             'HOST': 'localhost',
             'PORT': 27017
         }
     }
     

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