如何在自定义AdminSite上注册django-import-export-celery

核心问题分析 #

1. 你的AlmaAdmin继承的是原生import_export的ImportExportModelAdmin，而非django-import-export-celery提供的异步版本，导致自定义站点无法触发Celery任务。
2. 注册ImportJob和ExportJob时参数错误，第二个参数应为对应模型的Admin类，而非其他业务模型。

具体修复步骤 #

1. 修改Admin类的继承关系 #

在admin.py中，替换原生的ImportExportModelAdmin为django-import-export-celery提供的版本，确保异步导入导出功能生效：

# admin.py
from django.contrib import admin
from django.contrib.admin import AdminSite
from import_export_celery.admin import ImportExportModelAdmin, ImportJobAdmin, ExportJobAdmin
from import_export_celery.models import ImportJob, ExportJob
from .models import AlmaModel
from .resources import AlmaResource  # 建议将资源类单独存放，避免循环导入

class MyappAdminSite(AdminSite):
    # 自定义站点配置示例
    site_header = "My Custom Admin"
    site_title = "My Custom Admin Portal"

myadmin_site = MyappAdminSite(name='alma_admin')

class AlmaAdmin(ImportExportModelAdmin, admin.ModelAdmin):
    resource_classes = [AlmaResource]
    # 其他自定义配置（如列表显示字段、搜索字段等）...

# 注册业务模型到自定义站点
myadmin_site.register(AlmaModel, AlmaAdmin)

# 注册ImportJob和ExportJob到自定义站点，使用插件提供的Admin类
myadmin_site.register(ImportJob, ImportJobAdmin)
myadmin_site.register(ExportJob, ExportJobAdmin)

2. 分离资源类（可选但推荐） #

将AlmaResource从admin.py移到单独的resources.py文件中，减少模块耦合，避免循环导入问题：

# resources.py
from import_export import resources
from .models import AlmaModel

class AlmaResource(resources.ModelResource):
    class Meta:
        model = AlmaModel
        # 资源自定义配置（如导出字段、导入验证规则等）...

3. 保持settings.py配置不变 #

你的settings.py配置已经正确指向资源，仅需同步资源类的导入路径（如果做了分离）：

# settings.py
def resource():
    from myapp.resources import AlmaResource  # 若资源类移到resources.py，修改此处路径
    return AlmaResource

IMPORT_EXPORT_CELERY_MODELS = {
    "AlmaModel": {
        'app_label': 'myapp',
        'model_name': 'AlmaModel',
        'resource': resource,
    }
}

IMPORT_EXPORT_CELERY_INIT_MODULE = "my_project.celery"
BROKER_URL = "redis://localhost:6379"

4. 启动Celery Worker #

确保Celery服务已启动，否则异步导入导出任务无法执行：

celery -A my_project worker --loglevel=info

关键注意事项 #

• 必须使用import_export_celery.admin.ImportExportModelAdmin替代原生import_export的对应类，这是开启异步功能的核心。
• 注册ImportJob/ExportJob时，第二个参数必须是它们对应的Admin类（插件提供的或自定义的），不能传入其他业务模型。
• 分离资源类可以降低admin模块的复杂度，避免导入冲突。

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