如何为Django Admin中的非标准pgvector字段添加自定义验证？

从错误回溯可以看到，问题出在Django内置字段的validate方法中：if not self.blank and value in self.empty_values:。pgvector的向量值（比如numpy.ndarray类型）是多元素数组，直接用value in self.empty_values会触发numpy的布尔值歧义错误——数组和单个空值比较会返回布尔数组，而if语句需要单个布尔值，因此抛出异常。

以下是几种可行的处理方式，按推荐优先级排序：

1. 自定义兼容的Vector字段（最优） #

继承pgvector的VectorField，重写validate方法，替换掉不兼容的空值检查逻辑：

from pgvector.django import VectorField
from django.core.exceptions import ValidationError

class ValidatedVectorField(VectorField):
    def validate(self, value, model_instance):
        # 跳过父类中导致错误的空值检查逻辑，自行实现向量专属验证
        if not self.blank:
            # 根据实际向量类型调整判断逻辑，此处以numpy数组为例
            if value is None or (hasattr(value, '__len__') and len(value) == 0):
                raise ValidationError(self.error_messages['blank'], code='blank')
        # 保留父类的其他验证逻辑（如果有）
        super(VectorField, self).validate(value, model_instance)

之后在模型中使用这个自定义字段替代原VectorField即可。

2. 重写模型的clean_fields方法 #

如果不想修改字段类，可以在模型中跳过向量字段的默认验证，手动实现检查：

from django.db import models
from pgvector.django import VectorField
from django.core.exceptions import ValidationError

class YourModel(models.Model):
    vector = VectorField(dimensions=128)
    # 其他字段...

    def clean_fields(self, exclude=None):
        exclude = exclude or []
        # 跳过vector字段的默认验证，避免触发错误
        super().clean_fields(exclude=exclude + ['vector'])
        
        # 手动验证vector字段
        vector_field = self._meta.get_field('vector')
        if not self.vector and not vector_field.blank:
            raise ValidationError({'vector': vector_field.error_messages['blank']})
        # 可选：添加维度校验
        if self.vector and len(self.vector) != vector_field.dimensions:
            raise ValidationError({'vector': f'向量必须为{vector_field.dimensions}维'})

3. 在Admin表单中自定义清洗逻辑 #

针对Admin场景，直接在表单层覆盖向量字段的清洗规则：

from django.contrib import admin
from django import forms
from .models import YourModel

class YourModelForm(forms.ModelForm):
    class Meta:
        model = YourModel
        fields = '__all__'

    def clean_vector(self):
        vector = self.cleaned_data.get('vector')
        field = self.fields['vector']
        # 处理空值验证
        if not vector and field.required:
            raise forms.ValidationError(field.error_messages['required'])
        # 处理维度验证
        if vector and len(vector) != 128:
            raise forms.ValidationError('向量必须为128维')
        return vector

class YourModelAdmin(admin.ModelAdmin):
    form = YourModelForm

admin.site.register(YourModel, YourModelAdmin)

你之前尝试的validators列表、重写模型clean方法，都无法覆盖Django字段底层validate方法中的空值检查逻辑——这个检查是在字段的clean流程中优先执行的，必须针对性替换或跳过这一步才能解决问题。

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