基于Djongo ORM：如何将Django AutoField改为十六进制适配MongoDB

嘿，这个问题我用Djongo集成Django和MongoDB的时候也踩过一模一样的坑！核心问题就是Django自带的AutoField是整数类型，但MongoDB默认会把_id存成12字节的十六进制ObjectId，两边类型不匹配就导致Admin里编辑数据报错。下面给你两个靠谱的解决办法：

办法一：自定义十六进制自动字段（HexAutoField） #

先在你的项目里建个fields.py文件，把这个自定义字段写进去：

import uuid
from django.db import models
from django.utils.translation import gettext_lazy as _

class HexAutoField(models.CharField):
    description = _("Hexadecimal auto-generated ID")

    def __init__(self, *args, **kwargs):
        # 固定24位长度（对应MongoDB ObjectId的十六进制格式）
        kwargs.setdefault('max_length', 24)
        kwargs.setdefault('primary_key', True)
        # 默认不让手动编辑，要是需要改可以把这个去掉
        kwargs.setdefault('editable', False)
        super().__init__(*args, **kwargs)

    def pre_save(self, model_instance, add):
        # 新增数据时自动生成唯一的十六进制ID
        if add and not getattr(model_instance, self.attname):
            # 用uuid生成唯一值，去掉中间的'-'后取前24位，和MongoDB ObjectId格式对齐
            hex_id = uuid.uuid4().hex[:24]
            setattr(model_instance, self.attname, hex_id)
            return hex_id
        return super().pre_save(model_instance, add)

    def db_type(self, connection):
        # 告诉Djongo把这个字段映射成MongoDB的ObjectId类型
        return 'objectid'

然后在你的模型里替换掉原来的AutoField：

from django.db import models
from .fields import HexAutoField

class YourModel(models.Model):
    id = HexAutoField()
    # 其他字段按需添加...

    class Meta:
        db_table = 'your_collection_name'  # 对应MongoDB里的集合名

最后在Admin里正常注册模型就行，因为这个字段本质是CharField，Admin会自动用文本框处理，完全兼容十六进制字符串。

办法二：直接用Djongo自带的ObjectIdField #

其实Djongo已经帮我们封装好了适配MongoDB ObjectId的字段，直接用更省事：

from djongo import models

class YourModel(models.Model):
    id = models.ObjectIdField(primary_key=True, editable=False)
    # 其他字段...

这个字段会自动生成MongoDB原生的ObjectId，和数据库里的_id完全匹配，Admin里也能正常显示和操作（要是想手动编辑ID，把editable=False改成True就行）。

为什么这两种办法能解决问题？ #

不管是自定义字段还是用Djongo自带的ObjectIdField，核心都是让Django模型的主键类型和MongoDB存储的_id类型对齐——要么是24位十六进制字符串，要么是原生ObjectId，这样就不会出现类型不匹配的问题，Admin也能正常识别和编辑数据了。

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