基于pinax-referrals搭建Django推荐系统的步骤验证及示例请求

你的思路方向是对的，但有几个细节需要调整才能让推荐系统正常工作，我帮你梳理并给出完整的可运行示例：

步骤1：修正Profile模型与信号处理 #

原代码的问题在于：

• 信号触发时还未创建Profile实例，直接访问user.profile会抛出RelatedObjectDoesNotExist错误
• Profile关联的应该是**推荐响应（Response）**而非推荐链接（Referral），因为一个Referral可以对应多个通过该链接注册的用户，Response才是单个用户的推荐行为记录

修正后的Profile模型：

from django.contrib.auth.models import User
from django.db import models
from django.dispatch import receiver
from account.signals import user_signed_up
from pinax.referrals.models import Response

class Profile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    # 存储用户对应的推荐响应记录，允许为空（非推荐注册的用户）
    referral_response = models.OneToOneField(
        Response, 
        null=True, 
        blank=True, 
        on_delete=models.SET_NULL,
        related_name="referral_user_profile"
    )

# 用户注册完成后自动创建Profile实例
@receiver(user_signed_up)
def handle_user_signed_up(sender, user, form, **kwargs):
    Profile.objects.get_or_create(user=user)

步骤2：修正自定义注册视图 #

原代码缺少将推荐响应关联到用户Profile的逻辑，且需要确保pinax-referrals的中间件已配置，才能从session中获取推荐链接的信息。

修正后的注册视图：

from account.views import SignupView
from pinax.referrals.models import Referral

class RegistrationView(SignupView):
    def after_signup(self, form):
        # 先执行父类的注册后逻辑
        super().after_signup(form)
        
        # 记录推荐响应：自动从session读取之前存储的referral信息
        # "USER_SIGNUP"是自定义的响应类型，可根据需求修改
        referral_response = Referral.record_response(self.request, "USER_SIGNUP")
        
        # 如果存在有效推荐响应，关联到当前用户的Profile
        if referral_response:
            self.request.user.profile.referral_response = referral_response
            self.request.user.profile.save()

补充：生成推荐链接的视图（关键步骤） #

要让推荐系统运行起来，还需要为已有用户生成带追踪参数的推荐链接：

from django.shortcuts import render
from pinax.referrals.models import Referral
from django.contrib.auth.decorators import login_required

@login_required
def generate_referral_link(request):
    # 为当前登录用户创建推荐链接，redirect_to是新用户注册后跳转的页面
    referral = Referral.create(
        user=request.user,
        redirect_to="/user/dashboard/"  # 替换为你的实际跳转路径
    )
    # 获取带ref参数的完整推荐URL
    referral_url = referral.get_url(request)
    return render(request, "referral/link.html", {"referral_url": referral_url})

必要的配置检查 #

确保你的settings.py中已添加以下配置：

INSTALLED_APPS = [
    # ... 其他已安装应用
    "pinax.referrals",
    "account",  # django-user-accounts 必须已安装
]

MIDDLEWARE = [
    # ... 其他中间件
    "pinax.referrals.middleware.SessionJumpingMiddleware",  # 必须添加，用于追踪推荐链接的session信息
]

完整流程说明 #

1. 已有登录用户访问generate_referral_link视图，获取带ref参数的推荐链接
2. 新用户点击该链接，SessionJumpingMiddleware会将referral ID存储到session中
3. 新用户通过自定义的RegistrationView完成注册
4. 注册后after_signup方法会记录推荐响应，并关联到新用户的Profile
5. 你可以通过user.profile.referral_response.referral.user获取推荐该用户的老用户

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