MySQL后端下Django PointField经纬度数据库约束问题

我定义了如下Django模型：

class Place(models.Model):
    location = models.PointField(geography=True)

发现location字段可以接受任意经纬度数值，甚至超出经度±180、纬度±90的合法范围。调研后发现原因是数据库列未设置SRID，虽然数据库由Django自动生成，但MySQL后端似乎不支持在数据库层面正确配置SRID。

为避免这个问题，我尝试给该字段添加约束，但始终无法生成可正常运行的约束对象。理想方案是检查经纬度是否在PointField的合法范围内，退而求其次也可以接受硬编码范围限制。另外，如果有不需要额外Django约束、能让数据库直接遵守经纬度限制的方案，也非常感谢。

我试过多种写法，都没法同时满足Python和MySQL的要求，示例如下：

第一种写法：

class GeometryPointFunc(Func):
    template = "%(function)s(%(expressions)s::geometry)"

    def __init__(self, expression: any) -> None:
        super().__init__(expression, output_field=FloatField())


class Latitude(GeometryPointFunc):
    function = "ST_Y"


class Longitude(GeometryPointFunc):
    function = "ST_X"

...

class Meta:
    constraints = [models.CheckConstraint(condition=models.Q(Latitude("location")__lte=90), name="lat_lte_extent_lat")]

第二种写法：

class Meta:
    constraints = [models.CheckConstraint(condition=models.Q(Latitude("location")<=90), name="lat_lte_extent_lat")]

第三种写法：

class Meta:
    constraints = [models.CheckConstraint(condition=models.Q(90__gte=Latitude("location"), name="lat_lte_extent_lat")]

解决方案 #

方案一：修正自定义Func适配MySQL语法 #

MySQL的几何函数语法不需要::geometry类型转换，ST_Y/ST_X可直接作用于地理字段。调整自定义Func如下：

from django.db.models import Func, FloatField, CheckConstraint, Q

class Latitude(Func):
    function = 'ST_Y'
    output_field = FloatField()

class Longitude(Func):
    function = 'ST_X'
    output_field = FloatField()

class Place(models.Model):
    location = models.PointField(geography=True)

    class Meta:
        constraints = [
            CheckConstraint(
                condition=Q(location__isnull=False) & 
                          Q(Latitude('location')__gte=-90) & 
                          Q(Latitude('location')__lte=90),
                name='lat_between_90'
            ),
            CheckConstraint(
                condition=Q(location__isnull=False) & 
                          Q(Longitude('location')__gte=-180) & 
                          Q(Longitude('location')__lte=180),
                name='lon_between_180'
            )
        ]

该写法生成的SQL会直接调用MySQL原生函数，添加合法范围的检查约束。

方案二：模型层clean方法验证 #

在模型的clean方法中做前置验证，保存前拦截非法值：

from django.contrib.gis.geos import Point
from django.core.exceptions import ValidationError

class Place(models.Model):
    location = models.PointField(geography=True)

    def clean(self):
        super().clean()
        if self.location:
            lon, lat = self.location.coords
            if not (-180 <= lon <= 180):
                raise ValidationError(f"经度{lon}超出范围，必须在-180到180之间")
            if not (-90 <= lat <= 90):
                raise ValidationError(f"纬度{lat}超出范围，必须在-90到90之间")

这种方式在Django层面拦截非法值，适合需要即时反馈的场景，建议和数据库约束配合使用，形成双重保障。

方案三：强制设置SRID（MySQL 8.0+） #

若使用MySQL 8.0及以上版本，可手动指定SRID为4326（WGS84标准），部分版本的MySQL会对该SRID的地理字段做范围校验：

class Place(models.Model):
    location = models.PointField(geography=True, srid=4326)

注意：MySQL对地理字段的SRID支持存在版本差异，需测试确认是否生效。

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