Django模型主键从Int改为UUID4后Admin详情页无法加载

问题概况 #

将模型主键从默认Int类型改为UUID4后，Admin列表页显示正常，生成的对象链接格式正确（示例：http://localhost:8000/admin/images/image/27ce8dbc-eb3f-443d-bf04-f612093cdc46/change/），但点击链接进入详情页时会出现无限加载的情况——浏览器标签仅显示加载动画，控制台无报错，Django开发服务器也无日志输出。所有使用UUID作为主键的Admin都存在此问题，用Int主键的Admin则完全正常。

模型代码 #

class Image(models.Model):
    """Uploaded images."""
    id = models.UUIDField(primary_key=True, default=uuid4)
    # 其他字段...

环境说明 #

• 仅修改了模型主键类型为UUID4，未做其他改动
• 测试Django版本：v4.0.7、v4.1.1
• 测试浏览器：Google Chrome

当前日志配置 #

LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'filters': {
        'require_debug_false': {
            '()': 'django.utils.log.RequireDebugFalse',
        },
        'require_debug_true': {
            '()': 'django.utils.log.RequireDebugTrue',
        },
        'require_testing_false': {
            '()': RequireTestingFalse,
        },
    },
    'handlers': {
        'console': {
            'level': 'INFO',
            'filters': ['require_debug_true'],
            'class': 'logging.StreamHandler',
        },
        'file': {
            'level': 'ERROR',
            'filters': ['require_debug_false', 'require_testing_false'],
            'class': 'logging.FileHandler',
            'filename': os.path.join(BASE_DIR, 'logs/django.log'),
        },
        'mail_admins': {
            'level': 'ERROR',
            'filters': ['require_debug_false', 'require_testing_false'],
            'class': 'django.utils.log.AdminEmailHandler',
        },
    },
    'loggers': {
        'django': {
            'handlers': [
                'console',
            ],
        },
        'django.request': {
            'handlers': [
                'file',
                'mail_admins',
            ],
            'level': 'ERROR',
            'propagate': False,
        },
        'django.security': {
            'handlers': [
                'file',
                'mail_admins',
            ],
            'level': 'ERROR',
            'propagate': False,
        },
        'py.warnings': {
            'handlers': ['console'],
        },
    },
}

排查与解决思路 #

1. 检查模型关联字段：如果模型存在外键关联（尤其是自关联或关联其他UUID主键模型），且Admin配置了autocomplete_fields或raw_id_fields，可能引发循环查询导致死加载。可以暂时注释关联字段，验证是否能正常加载页面。

2. 升级Django版本：Django 4.0.x和4.1.x的部分版本存在UUID主键Admin加载的bug，建议升级到4.2及以上的稳定版，看是否修复该问题。

3. 调整Admin配置：

   • 显式指定Admin的fields或fieldsets，避免自动渲染所有字段，逐个排查是否有字段引发加载异常；
   • 暂时禁用autocomplete_fields、readonly_fields中的可疑字段，或移除list_display中的关联字段测试。

4. 开启详细日志排查：修改日志配置，将django.request的日志级别改为DEBUG，并让控制台输出该日志，以便查看请求处理过程中的细节：

   LOGGING = {
       # 保留原有配置，仅修改以下部分
       'handlers': {
           'console': {
               'level': 'DEBUG',
               'filters': ['require_debug_true'],
               'class': 'logging.StreamHandler',
           },
       },
       'loggers': {
           'django.request': {
               'handlers': ['console', 'file', 'mail_admins'],
               'level': 'DEBUG',
               'propagate': False,
           },
       },
   }
   

5. 检查浏览器网络请求：打开Chrome开发者工具（F12）的Network标签，查看是否有请求处于pending状态，或静态资源加载失败，导致页面无法完成渲染。

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