MySQL 8添加空间索引报错1252：无NULL值却提示需非空

核心原因 #

MySQL的空间索引有硬性要求：被索引的列必须显式设置NOT NULL约束——哪怕表中所有数据都没有NULL值，只要列的定义允许NULL，就无法创建空间索引，这就是你遇到ERROR 1252的根本原因。

解决步骤 #

1. 修改列约束为NOT NULL
   先将geoPoint列的约束改为不允许NULL：

   ALTER TABLE geoloc MODIFY COLUMN geoPoint POINT NOT NULL;
   

   如果执行这条语句时报错，说明表中可能存在隐藏的无效空间数据（比如空的POINT对象POINT EMPTY，这类数据不属于NULL，但会被空间索引判定为无效），可以用以下语句排查：

   -- 检查无效的空间对象
   SELECT * FROM geoloc WHERE ST_ISVALID(geoPoint) = 0;
   -- 检查空空间对象
   SELECT * FROM geoloc WHERE geoPoint = ST_GeomFromText('POINT EMPTY');
   

   清理掉这类数据后再重新执行修改约束的语句。

2. 创建空间索引
   约束修改完成后，即可正常创建空间索引：

   CREATE SPATIAL INDEX idx_geopoint ON geoloc(geoPoint);
   

额外验证 #

可以先确认所有行的geoPoint都有效且非NULL：

-- 总行数
SELECT COUNT(*) FROM geoloc;
-- 非NULL且有效的行数
SELECT COUNT(*) FROM geoloc WHERE geoPoint IS NOT NULL AND ST_ISVALID(geoPoint) = 1;

如果两个数值一致，说明数据没问题，只需修改列约束即可。

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