DRF序列化响应报错：ValueError: 检测到循环引用（含变量时）

错误根源 #

你的代码存在两个关键问题，其中循环引用错误由第一点直接导致：

• 遍历acls的循环里，错误地将filenames列表本身添加到了列表中：filenames.append(filenames)。这会让列表内部嵌套自身，形成无限递归结构，DRF序列化时无法处理这种循环引用，从而抛出错误。
• data字典的定义放在循环内部，会导致每次循环都覆盖之前的data，最终只有最后一个文件名被保留在reports列表中。

修正后的代码 #

ViewSet中create方法的修正片段 #

case "1":
    acls = ACL.objects.filter(id__in=ids)
    if len(acls)>0:
        filenames = []
        timestamp = calendar.timegm(time.gmtime())
        for acl in acls:
            # 创建文件名
            device_name = acl.device.name
            acl_name = acl.name
            filename = f"Matrix_Report_{device_name}_{acl_name}_{timestamp}"
            # 提交报告生成任务
            generate_matrix_report.delay(acl, filename)
            filenames.append(filename)  # 修正：添加生成的filename字符串，而非列表本身
        # 将data定义移到循环外，确保收集所有文件名
        data = {"message": "Reports generation requested successfully", "reports": filenames}
        response_serializer = serializers.RequestReportResponseSerializer(data=data)
        response_serializer.is_valid(raise_exception=True)  # 建议添加，确保序列化有效性
        return Response(data=response_serializer.data)

额外说明 #

• 即使不使用序列化器直接返回字典，只要filenames列表包含自身，就会触发循环引用错误，所以核心问题是列表追加的内容错误。
• 加上response_serializer.is_valid(raise_exception=True)可以在序列化数据不符合要求时及时抛出异常，便于调试。

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