Django ORM中如何将Varchar类型IP转换为inet后进行子网匹配？

问题根源 #

Django ORM的net_contained等IP子网相关查询仅支持GenericIPAddressField类型字段，你的ip_address是CharField，直接调用会触发类型不兼容的错误。而PostgreSQL中通过inet()函数转换字段类型的操作，需要在Django中用自定义数据库函数来实现。

实现方法 #

方法1：用Func转换字段后过滤 #

通过Django的Func类包装ip_address字段，调用PostgreSQL的INET函数转换为IP类型，再使用net_contained查询：

首先导入必要的类：

from django.db.models import Func, F
from django.db import models

定义一个封装INET函数的类（复用性更高）：

class Inet(Func):
    function = 'INET'
    output_field = models.GenericIPAddressField(protocol='both')

然后执行查询：

# 假设subnet_mask是你的子网，比如'10.0.0.2/24'
YourModel.objects.annotate(
    converted_ip=Inet(F('ip_address'))
).filter(converted_ip__net_contained=subnet_mask)

也可以直接在filter中内联使用，无需单独定义类：

YourModel.objects.filter(
    Func(
        F('ip_address'),
        function='INET',
        output_field=models.GenericIPAddressField(protocol='both')
    )__net_contained=subnet_mask
)

方法2：修改字段类型（推荐长期方案） #

如果数据库允许修改字段类型，直接将ip_address改为GenericIPAddressField，后续就可以直接使用net_contained等lookup：

# 在模型中修改字段
ip_address = models.GenericIPAddressField(protocol='both', null=True, blank=True)

然后生成迁移文件并执行迁移，之后就能直接查询：

YourModel.objects.filter(ip_address__net_contained=subnet_mask)

关于功能支持的说明 #

Django本身并未禁止对转换后的IP类型使用子网查询，只是默认的net_contained lookup仅绑定GenericIPAddressField。通过Func将CharField转换为数据库层面的inet类型后，即可正常使用这些IP相关的查询功能，不存在功能不支持的问题。

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