Django HTML模板无法访问外键元素问题求助

问题场景 #

在Django项目中使用PostgreSQL数据库，HTML模板里无法显示外键对象的属性，对应列无内容。相关代码如下：

Views代码 #

def search_devis(request):
    devis = Devis.objects.all()
    commercial = User.objects.all()
    client = Client.objects.all()

    context={
        'devis': devis,
        'commercial': commercial,
        'client_': client,

    }
    return render(request, "manage_devis/search_devis.html",context )

Models代码 #

class Devis(models.Model):
    titre = models.CharField(max_length=30, )
    date_ecriture = models.DateField(auto_now_add=True)
    date_expiration = models.DateField()
    client = models.ForeignKey(Client, name="CLIENT_FK", default=1 ,on_delete=models.SET_DEFAULT)
    total = models.DecimalField(max_digits=10, decimal_places=2)
    commercial = models.ForeignKey(User, name="COMMERCIALFK", default=1 ,on_delete=models.SET_DEFAULT)
    def __str__(self):
        return "DV"+str(self.pk)

Templates代码 #

{% for devis_ in devis %}
    <tr>
        <th scope="row"><a href="{% url 'view_devis' devis_.pk %}">DV{{devis_.id }}</a></th>
    <td>{{ devis_.date_ecriture }}</td>
    <td>{{ devis_.date_expiration }}</td>
    <td>{{devis_.client.nom}}</td>
    <td>{{ devis_.total}} DH</td>
    <td>{{ devis_.commercial.last_name}}</td>
    </tr>
{% endfor %}

排查与解决步骤 #

• 检查外键默认值关联对象
  模型中外键设置了default=1，需确认PostgreSQL中client表和auth_user表是否存在id=1的记录。如果不存在，要么创建对应id的对象，要么修改default值为数据库中存在的有效id。

• 修复ForeignKey的name参数问题
  Django的ForeignKey的name参数是指定数据库表的外键字段名，而非模型属性名。当前设置的name可能导致ORM映射异常，建议移除该参数，让Django自动生成标准字段名（如client_id、commercial_id），修改后的模型代码如下：

  class Devis(models.Model):
      titre = models.CharField(max_length=30)
      date_ecriture = models.DateField(auto_now_add=True)
      date_expiration = models.DateField()
      client = models.ForeignKey(Client, default=1, on_delete=models.SET_DEFAULT)
      total = models.DecimalField(max_digits=10, decimal_places=2)
      commercial = models.ForeignKey(User, default=1, on_delete=models.SET_DEFAULT)
      
      def __str__(self):
          return f"DV{self.pk}"
  

• 用select_related优化外键查询
  原视图中Devis.objects.all()会触发N+1查询，虽不至于直接导致数据为空，但可能因查询异常引发问题。使用select_related提前关联外键对象，同时移除模板中未使用的commercial和client_查询：

  def search_devis(request):
      devis = Devis.objects.all().select_related('client', 'commercial')
      context = {
          'devis': devis,
      }
      return render(request, "manage_devis/search_devis.html", context )
  

• 验证模型字段名拼写
  确认Client模型确实存在nom字段，User模型存在last_name字段，若字段名拼写错误会导致模板无法获取数据。

• 检查数据库外键关联数据
  直接查询PostgreSQL的devis表，确认外键字段（CLIENT_FK或修改后的client_id）的值是否关联到client表的有效记录，COMMERCIALFK（或commercial_id）是否关联到auth_user表的有效记录，无效的关联值会导致模板显示为空。

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