MySQL ST_GeomFromText 怎样把 WKT 文本转成空间对象

在 MySQL 里接收地图点位、线路或区域时，外部数据经常先以 WKT（Well-Known Text）出现。把它写进空间列，核心函数就是 ST_GeomFromText(wkt[, srid[, options]])：第一个参数是 WKT 文本，第二个参数可选，用来指定空间参考系。它返回的是 MySQL 内部空间对象，不是普通字符串。

官方地址：https://dev.mysql.com/doc/refman/8.4/en/gis-wkt-functions.html

先把 WKT、空间对象和 SRID 分开

WKT 是交换格式，空间对象是 MySQL 用来存储和参与空间函数运算的值，SRID 则是附着在对象上的空间参考系标识。三者混在一起时，最容易出现“文本看起来没问题，但入库后语义不对”的情况。

例如，一个点的 WKT 写法是 POINT(116.397 39.908)。这里的两个数字由空格分开，不能照搬 SQL POINT(116.397, 39.908) 函数的逗号写法。先把文本转成对象并回读，适合用作最小验证：

-- 将 WKT 文本转换成空间对象；SRID 只是示例编号，按业务坐标系选择
SET @point_value = ST_GeomFromText('POINT(116.397 39.908)', 4326);

-- 转回可读的 WKT，确认对象的几何文本
SELECT ST_AsText(@point_value) AS wkt_text,
       ST_SRID(@point_value) AS srid_value;

这段写法的重点不是某一组坐标，而是把“文本格式”和“参考系元数据”同时保留下来。若只传第一个参数，MySQL 会使用函数和列环境允许的默认语义；在需要明确坐标系的表中，建议显式传入 SRID。

从最小写法迁移到空间列

ST_GeomFromText 的第一个参数可以是不同几何类型的 WKT。点、线、面并不需要更换总函数，只要文本符合相应语法即可：

-- 三种几何文本对应三种空间对象
SELECT ST_GeomFromText('POINT(116.397 39.908)', 4326) AS point_value,
       ST_GeomFromText('LINESTRING(116.3 39.9,116.4 39.95)', 4326) AS line_value,
       ST_GeomFromText('POLYGON((116.3 39.9,116.4 39.9,116.4 40.0,116.3 39.9))', 4326) AS polygon_value;

真正入库时，空间列的类型和 SRID 应该与输入约定一致。下面的表只演示边界，不代表所有项目都应使用同一坐标系：

-- 空间列声明 SRID 后，列值需要保持同一空间参考系
CREATE TABLE place_point (
    id BIGINT PRIMARY KEY,
    name VARCHAR(80) NOT NULL,
    location POINT SRID 4326 NOT NULL
);

-- 示例使用固定文本；应用代码应把 WKT 和名称作为参数绑定
INSERT INTO place_point (id, name, location)
VALUES (1, '示例位置', ST_GeomFromText('POINT(116.397 39.908)', 4326));

应用层不要把用户输入直接拼进 SQL。正确的迁移方向是：先在应用里得到合法 WKT，再把它作为绑定参数传给 ST_GeomFromText(?, 4326)。这样既能保持 SQL 结构稳定，也能把文本格式错误和业务校验错误分开处理。

回读时同时检查文本和参考系

空间值在表里不是普通字符串。调试或接口输出时，用 ST_AsText 把它转换成 WKT；需要确认参考系时，再读取 ST_SRID。只看坐标文本，无法证明对象的 SRID 正确。

-- 将空间列转换成接口或日志更容易理解的 WKT
SELECT id,
       name,
       ST_AsText(location) AS location_wkt,
       ST_SRID(location) AS location_srid
FROM place_point
WHERE id = 1;

如果返回的坐标顺序、括号或几何类型不符合输入预期，先检查 WKT 本身；如果坐标文本正常但空间运算结果异常，再检查 SRID 是否和数据来源、列声明以及后续函数的预期一致。读取阶段不要用二进制内部值替代 ST_AsText，那会让日志和接口难以复核。

四个常见格式边界

这套检查顺序适合把格式问题和坐标系问题拆开。空间索引、距离计算和坐标转换属于下一层问题，不要在 WKT 尚未稳定时一起改动。

相关问题

ST_GeomFromText 和 ST_GeometryFromText 有什么区别？

在 MySQL 文档中它们属于同一类从 WKT 创建几何值的函数名，通常按项目约定选择一种写法即可；关键仍是 WKT 语法和 SRID。

为什么 ST_AsText 的结果和输入字符串不完全一样？

回读结果是 MySQL 规范化后的 WKT 表示，空格或小数格式可能变化。判断是否正确时，应关注几何类型、坐标值和 SRID，而不是逐字符比较原字符串。

只传 WKT 不传 SRID 可以吗？

函数签名允许省略可选 SRID，但是否适合当前表和业务要看空间列声明及后续运算约束。需要明确坐标参考系时，显式传参更容易排查。