Django集成PayPal支付网关：无法触发信号及接收IPN通知

看起来你在把Django应用和PayPal支付网关集成时，卡在了IPN通知接收和信号触发这两步——这确实是PayPal集成里最容易踩坑的地方，我来帮你梳理几个关键的排查方向和解决方案：

一、先把IPN的基础配置捋顺 #

IPN通知收不到，大概率是基础配置出了问题，先从这里查：

• 确认PayPal账户的IPN开关和地址：
  登录PayPal商家后台（一定要用沙箱环境测试，别碰生产环境），找到IPN设置页面，必须开启IPN功能，并且把通知URL填成你Django应用里处理IPN的视图地址，比如https://your-domain.com/paypal/ipn/。注意PayPal只认HTTPS地址，本地测试的话得用ngrok这类工具把本地服务暴露成HTTPS链接。
• 确保IPN视图能正确响应：
  PayPal会反复发送IPN请求，直到收到200状态码的响应——如果你的视图抛出异常或者返回非200，PayPal就会停止重试。给你个基础的IPN视图示例，记得加上csrf_exempt（因为PayPal的请求是跨域的）：

  from django.http import HttpResponse
  from django.views.decorators.csrf import csrf_exempt
  from paypal.standard.ipn.views import paypal_ipn
  
  @csrf_exempt
  def paypal_ipn_handler(request):
      # 调用官方库的IPN处理逻辑
      response = paypal_ipn(request)
      # 必须返回200，告诉PayPal我们收到了
      return HttpResponse(status=200)
  

  还要在urls.py里配置好对应的路由：

  urlpatterns = [
      # ...其他路由
      path('paypal/ipn/', paypal_ipn_handler, name='paypal-ipn'),
  ]
  

二、信号触发问题的排查 #

不管是用django-paypal的内置信号，还是你自定义的信号，这几点一定要检查：

• 信号注册是否到位：
  信号接收器不能随便放，最好放在单独的signals.py文件里，然后在apps.py的ready()方法里导入它，确保Django启动时能加载到：

  # apps.py
  from django.apps import AppConfig
  
  class YourAppConfig(AppConfig):
      default_auto_field = 'django.db.models.BigAutoField'
      name = 'your_app'
  
      def ready(self):
          # 导入信号接收器
          import your_app.signals
  

  别忘了在应用的__init__.py里指定这个配置：

  # __init__.py
  default_app_config = 'your_app.apps.YourAppConfig'
  

• 信号触发时机是否正确：
  如果是用自定义信号，得确保在IPN验证通过后手动发送信号。比如当PayPal返回支付成功的IPN时，找到对应的Purchase对象再发信号：

  from django.dispatch import Signal
  # 定义自定义信号
  payment_completed = Signal(providing_args=["purchase"])
  
  # 在IPN视图中处理
  @csrf_exempt
  def paypal_ipn_handler(request):
      ipn_obj = paypal_ipn(request)
      if ipn_obj.payment_status == 'Completed':
          # 这里假设你把Purchase关联的Pr_request.number作为invoice传给了PayPal
          try:
              purchase = Purchase.objects.get(resourse__number=ipn_obj.invoice)
              # 发送信号
              payment_completed.send(sender=None, purchase=purchase)
          except Purchase.DoesNotExist:
              # 日志记录找不到订单的情况
              import logging
              logger = logging.getLogger(__name__)
              logger.error(f"Purchase not found for invoice {ipn_obj.invoice}")
      return HttpResponse(status=200)
  

• 接收器逻辑有没有隐藏异常：
  很多时候信号看似没触发，其实是接收器里抛出了异常。给接收器加个日志，方便调试：

  import logging
  from django.dispatch import receiver
  from paypal.standard.ipn.signals import payment_was_successful
  
  logger = logging.getLogger(__name__)
  
  @receiver(payment_was_successful)
  def handle_payment_success(sender, **kwargs):
      ipn_obj = sender
      logger.info(f"收到PayPal成功支付通知：交易ID {ipn_obj.txn_id}")
      try:
          # 处理你的业务逻辑，比如更新Purchase状态
          purchase = Purchase.objects.get(resourse__number=ipn_obj.invoice)
          purchase.paid = True  # 假设你有个paid字段标记是否支付
          purchase.save()
      except Purchase.DoesNotExist:
          logger.error(f"找不到对应订单：发票号 {ipn_obj.invoice}")
  

三、本地测试的特殊注意事项 #

• 用PayPal沙箱模拟器测试：
  直接用沙箱的IPN模拟器，输入你的IPN URL，模拟支付成功的通知，然后看Django的日志有没有收到请求——如果没收到，先检查ngrok是否正常，或者服务器的防火墙、反向代理（比如Nginx）有没有拦截请求。
• 检查模型字段完整性：
  你提供的Purchase模型里purchased_at字段定义不完整，记得补全，比如models.DateTimeField(auto_now_add=True)，避免因为字段问题导致数据库操作失败，进而影响信号触发。

最后，强烈建议开启Django的DEBUG日志，把请求和异常信息都打出来，这样能快速定位到底是IPN没进来，还是信号处理时出了问题。

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