如何限制Django模型中star字段的取值范围为0-5

一、后端从根源阻止非法值 #

首先纠正模型字段的错误定义：IntegerField的max_length参数是无效的，必须通过验证器来限制取值范围，同时可以加强模型级别的验证确保数据合法。

1. 给字段添加范围验证器 #

修改products模型中的star字段，引入Django内置的范围验证器：

from django.db import models
from django.core.validators import MinValueValidator, MaxValueValidator

class Product(models.Model):
    # 其他字段...
    star = models.IntegerField(
        default=0,
        validators=[
            MinValueValidator(0, message="评分不能低于0"),
            MaxValueValidator(5, message="评分不能高于5")
        ]
    )

这样在通过管理后台、表单提交数据时，会自动校验star的值是否在0-5之间，不符合要求会抛出错误。

2. 重写模型clean方法（可选） #

如果存在直接通过代码（比如shell）修改数据库的场景，验证器可能不触发，这时可以重写模型的clean方法加强校验：

from django.core.exceptions import ValidationError

class Product(models.Model):
    # 其他字段和验证器...

    def clean(self):
        super().clean()
        if not (0 <= self.star <= 5):
            raise ValidationError({"star": "评分必须在0到5之间"})

调用模型的full_clean()方法时会触发这个验证，确保入库数据绝对合法。

3. 表单层验证（如果用表单提交评分） #

如果是通过前端表单提交评分，在表单类中也可以添加字段级验证：

from django import forms
from .models import Product

class ProductForm(forms.ModelForm):
    class Meta:
        model = Product
        fields = ['star', ...]

    def clean_star(self):
        star = self.cleaned_data.get('star')
        if not (0 <= star <= 5):
            raise forms.ValidationError("评分必须在0到5之间")
        return star

二、前端容错处理（避免显示异常） #

即使后端处理了，可能存在历史非法数据或者前端传值异常的情况，需要在模板中限制显示的星星数量：

方法1：自定义模板过滤器（推荐） #

1. 在你的app目录下创建templatetags文件夹（如果没有），里面新建star_filters.py文件：

from django import template

register = template.Library()

@register.filter
def clamp(value, args):
    min_val, max_val = map(int, args.split(','))
    # 确保值在min和max之间，超出则取边界值
    return max(min_val, min(int(value) if value is not None else min_val, max_val))

2. 在模板中加载过滤器并使用：

{% load star_filters %}
<div class="d-flex justify-content-center small text-warning mb-2">
    {% with valid_star=item.star|clamp:"0,5" %}
        {% with ''|center:valid_star as range %}
            {% for _ in range %}
                <div class="bi-star-fill"></div>
            {% endfor %}
        {% endwith %}
    {% endwith %}
</div>

方法2：用内置标签做条件判断（无需自定义） #

如果不想写自定义过滤器，可以直接在模板中用条件判断处理：

<div class="d-flex justify-content-center small text-warning mb-2">
    {% with star=item.star|default:0 %}
        {% if star > 5 %}
            {% with display_star=5 %}
                {% with ''|center:display_star as range %}
                    {% for _ in range %}
                        <div class="bi-star-fill"></div>
                    {% endfor %}
                {% endwith %}
            {% endwith %}
        {% elif star < 0 %}
            {% with display_star=0 %}
                {% with ''|center:display_star as range %}
                    {% for _ in range %}
                        <div class="bi-star-fill"></div>
                    {% endfor %}
                {% endwith %}
            {% endwith %}
        {% else %}
            {% with ''|center:star as range %}
                {% for _ in range %}
                    <div class="bi-star-fill"></div>
                {% endfor %}
            {% endwith %}
        {% endif %}
    {% endwith %}
</div>

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