在 Django-Q2 中，定时任务（Schedule）不支持直接传入绑定方法（如 self.run_function），必须使用字符串形式的函数路径；而异步任务（async_task）可接受绑定方法，这是两者核心差异。解决方案是将逻辑提取到独立函数，并通过 kwargs 传递实例 ID 进行反查。
在 django-q2 中，定时任务（schedule）不支持直接传入绑定方法（如 `self.run_function`），必须使用字符串形式的函数路径；而异步任务（async_task）可接受绑定方法，这是两者核心差异。解决方案是将逻辑提取到独立函数，并通过 `kwargs` 传递实例 id 进行反查。
Django-Q2 的 Schedule 模型要求 func 和 hook 字段必须为可导入的点分字符串（dotted string），例如 'myapp.tasks.process_data'，而非 Python 对象引用（如
相比之下，async_task() 在当前进程上下文中立即序列化调用，且可能复用相同内存空间，因此能临时支持绑定方法（但不推荐用于生产环境，存在隐式耦合与序列化风险）。
✅ 正确实践：将业务逻辑解耦至 tasks.py，使用标准函数 + 显式参数传递：
# test_app/tasks.py
from django.apps import apps
def run_function(**kwargs):
"""执行 TestApp 关联的函数，需通过 ID 反查实例"""
test_app_id = kwargs.get('TestApp_id')
if not test_app_id:
raise ValueError("Missing 'TestApp_id' in kwargs")
TestApp = apps.get_model('test_app', 'TestApp')
try:
test_app = TestApp.objects.get(pk=test_app_id)
except TestApp.DoesNotExist:
raise RuntimeError(f"TestApp with id {test_app_id} not found")
# 动态加载模块与函数
module = __import__(test_app.test_function.library_name)
func = getattr(module, test_app.test_function.function_name)
# 解包参数并执行
result = func(*test_app.get_args())
print(f"[Task] Executed {test_app.id}: {result}")
return {
'result': result,
'TestApp_id': test_app_id
}
def print_task(task):
"""Hook 函数：接收 Task 实例，读取其 result 字段"""
if not hasattr(task, 'result') or not isinstance(task.result, dict):
print("[Hook] Invalid task result format")
return
app_id = task.result.get('TestApp_id')
result_val = task.result.get('result')
print(f"[Hook] TestApp #{app_id} completed → {result_val}")
对应地，在模型中创建 Schedule 时，必须使用字符串路径，并显式传参：
Django Unfold
下载
提供使用 django-unfold (v0.56+) 构建高级 Django 管理界面的专业指导。当用户提及 django-unfold、unfold admin 等内容时使用此技能。
# test_app/models.py
from django.db import models
from django_q.models import Schedule
class TestApp(models.Model):
cron = models.CharField(max_length=200)
args = models.CharField(max_length=200) # 存储如 "['arg1', 42]" 的字符串
test_function = models.ForeignKey('TestFunction', on_delete=models.CASCADE)
scheduled_task = models.ForeignKey(
Schedule, blank=True, null=True, on_delete=models.SET_NULL
)
def get_args(self):
import ast
return ast.literal_eval(self.args)
def save(self, *args, **kwargs):
# 删除旧任务（可选）
if self.scheduled_task:
self.scheduled_task.delete()
# 创建新 Schedule：func/hook 必须为 dotted string
self.scheduled_task = Schedule.objects.create(
func='test_app.tasks.run_function',
hook='test_app.tasks.print_task',
schedule_type=Schedule.CRON,
cron=self.cron,
kwargs={'TestApp_id': self.id}, # 关键：传递实例标识
repeats=-1, # 持续重复（按 cron 触发）
)
super().save(*args, **kwargs)
⚠️ 注意事项：
- 避免在 tasks.py 中直接 from .models import TestApp：可能导致循环导入；推荐使用 apps.get_model() 动态获取模型。
- kwargs 中的参数会被 JSON 序列化，因此仅支持基础类型（str, int, list, dict 等），不可传模型实例或函数对象。
- hook 函数接收的是 django_q.models.Task 对象，其 result 字段即 func 返回值（经序列化后还原），确保 run_function 返回字典以供 print_task 安全解析。
- 部署前务必运行 python manage.py qcluster 启动 Q cluster，并确认 settings.py 中已正确配置 Q_CLUSTER。
此方案符合 Django-Q2 的设计约束，保障了任务的可序列化性、跨进程可靠性与长期可维护性。
