MySQL ST_IsValid 怎样判断几何对象是否有效

在 MySQL 里，空间值能被构造成几何对象，不代表它一定符合几何有效性规则。判断一个对象能不能继续参与空间计算，最直接的入口是 ST_IsValid(g)：返回 1 表示几何有效，返回 0 表示几何无效。它只负责回答“是否有效”，不会替你修复对象。

官方文档：https://dev.mysql.com/doc/refman/8.4/en/spatial-convenience-functions.html

先用 ST_IsValid 做布尔判断，再根据业务决定拒绝、记录问题或进入修复流程。不要把返回 0 当成 SQL 语法错误，也不要把能解析 WKT 当成拓扑已经正确。

ST_IsValid 返回什么

下面这条查询就是最小用法。示例中的几何值仅用于说明输入形态，重点是观察函数承担的职责：

-- 先构造一个闭合的 Polygon，再判断它是否符合几何有效性规则
SET @parcel = ST_GeomFromText(
  'POLYGON((0 0, 4 0, 4 4, 0 4, 0 0))'
);

-- 返回 1 表示有效，返回 0 表示几何对象无效
SELECT ST_IsValid(@parcel) AS is_valid;

这里要区分三类结果：

• 1：对象在当前规则下几何有效，可以进入后续空间逻辑。
• 0：对象语法上可以作为几何值处理，但几何结构不满足有效性要求。
• NULL 或错误：通常要回头看输入是否为 NULL、是否是未定义的空间参考，或地理坐标是否越界。

为什么 WKT 能解析，ST_IsValid 仍可能返回 0

WKT 解析解决的是“这段文本能不能被解释为一个几何值”，而有效性还要看点、线、面之间的几何关系。例如一个线串可能只有一个点，面可能没有形成合理的闭环，或者多边形边界发生了不符合规则的交叉。解析成功与拓扑有效是两个层次。

可以把几种输入放在同一批查询里，便于在导入或排障时比较：

-- 点通常是最简单的几何输入
SET @point_value = ST_GeomFromText('POINT(120 30)');

-- 两个不同端点组成的线串，用来展示正常线性对象
SET @line_value = ST_GeomFromText('LINESTRING(0 0, 1 1)');

-- 连续重复同一点的线串，用来观察退化几何的判断结果
SET @degenerate_line = ST_GeomFromText('LINESTRING(0 0, 0 0, 0 0)');

-- 面的首尾闭合，示例用于说明有效面和退化输入的差别
SET @polygon_value = ST_GeomFromText(
  'POLYGON((0 0, 4 0, 4 4, 0 4, 0 0))'
);

-- 用 UNION ALL 保留每个输入的名称，方便批量导入前分流
SELECT 'point' AS geometry_name, ST_IsValid(@point_value) AS is_valid
UNION ALL
SELECT 'line', ST_IsValid(@line_value)
UNION ALL
SELECT 'degenerate_line', ST_IsValid(@degenerate_line)
UNION ALL
SELECT 'polygon', ST_IsValid(@polygon_value);

实际业务中，不要只看最终的布尔列。建议同时保留原始 WKT、对象类型、来源记录和判断时间。这样返回 0 时，能够回到原始数据找出是重复点、退化边界，还是上游坐标转换造成的问题。

NULL、空几何和地理坐标要分开处理

NULL 表示没有几何值，不等于“有一个无效几何”。空几何也有自己的表示边界：MySQL 文档把空的 GEOMETRYCOLLECTION 作为有效空几何，不能把它和某些 GIS 系统里的 POINT EMPTY 直接等同。

-- NULL 输入用于表示缺失值，不把缺失记录误判成几何无效
SELECT ST_IsValid(NULL) AS missing_geometry;

-- 空 GeometryCollection 是 MySQL 支持的空几何表示
SET @empty_collection = ST_GeomFromText('GEOMETRYCOLLECTION EMPTY');

-- 单独查看空集合的判断结果，避免和业务缺失值混在一起
SELECT ST_IsValid(@empty_collection) AS empty_collection_valid;

如果几何带有地理空间参考系，还要检查经度和纬度是否落在允许范围内。比如经度超过 -180 到 180 的范围，或者纬度超过 -90 到 90，调用有效性函数时可能直接产生坐标范围错误，而不是返回一个普通的 0。

-- 4326 是常见的地理坐标系示例；181 度经度用于说明越界分支
SET @out_of_range_point = ST_GeomFromText('POINT(181 30)', 4326);

-- 地理坐标越界应按错误处理，不要把它当作普通的 0 结果
SELECT ST_IsValid(@out_of_range_point) AS geographic_valid;

ST_IsValid 和 ST_Validate 怎么分工

两个函数名字接近，但用途不同：

ST_Validate 不是“把所有坏数据无条件修好”的开关。它在输入几何无效时可能返回 NULL，而且修复会改变数据形态，是否接受结果必须由业务规则决定。先判断、再保留原值和修复值，通常更容易追溯：

-- 假设 source_geometry 是待处理的空间列
SELECT
  id,
  -- 先记录原始判断，便于统计无效数据的比例
  ST_IsValid(source_geometry) AS source_is_valid,
  -- 仅把修复结果作为候选值，不覆盖原始几何
  ST_Validate(source_geometry) AS candidate_geometry
FROM spatial_import_queue
WHERE id = 1001;

导入流程中怎样安排判断

如果数据来自文件、接口或其他 GIS 系统，可以把流程分成三个字段：原始输入、解析后的几何、有效性结果。不要在第一条 SQL 中直接覆盖原始值。

-- 只把有效几何送入业务表，问题记录留在队列表中继续处理
INSERT INTO parcel_ready (source_id, geometry_value)
SELECT source_id, source_geometry
FROM spatial_import_queue
WHERE source_geometry IS NOT NULL
  -- 过滤出符合几何规则的对象
  AND ST_IsValid(source_geometry) = 1;

-- 另行记录无效对象，保留原几何便于回放或人工处理
INSERT INTO parcel_rejected (source_id, geometry_value, reject_reason)
SELECT source_id, source_geometry, 'geometry-invalid'
FROM spatial_import_queue
WHERE source_geometry IS NOT NULL
  AND ST_IsValid(source_geometry) = 0;

这类分流的关键不是让 SQL 变复杂，而是让“缺失值、格式错误、几何无效、坐标越界”在数据链路上有不同去向。后续再决定是否调用 ST_Validate、是否人工修复，或者直接退回上游。

常见问题

ST_IsValid 返回 0 是不是 WKT 写错了？

不一定。WKT 可能已经成功解析，但几何拓扑仍然无效。要把文本格式、几何有效性和坐标范围分别记录。

空 GeometryCollection 算有效吗？

在 MySQL 8.4 的规则下，空的 GeometryCollection 是支持的空几何表示，ST_IsValid 可以返回有效结果；它与 NULL 不是同一种状态。

ST_IsValid 会自动修复 Polygon 吗？

不会。ST_IsValid 只返回判断结果。需要候选修复值时再单独评估 ST_Validate，并保留原始几何。

经纬度越界为什么不是返回 0？

地理空间参考系下，越界坐标属于参数错误边界，函数可能直接报错。调用方应把它和普通几何无效分开捕获。

小结

MySQL 的 ST_IsValid 适合做空间数据链路里的前置判断：1 表示有效，0 表示几何无效；NULL、空集合和地理坐标越界则要按各自语义处理。它解决的是“能不能继续用”的判断问题，不能替代修复策略。把原始值、判断结果和候选修复值分开保存，排障和回滚都会更清楚。