MySQL ST_SwapXY 怎样交换几何对象的坐标分量

MySQL ST_SwapXY(g) 接收内部几何值，将几何中每一对坐标的 X、Y 分量对调，返回新的几何结果。例如平面点 (3,11) 交换后为 (11,3)，折线则对所有顶点做同样处理。它修改坐标值的排列，不能代替坐标系投影转换；如果只是导入或输出文本的经纬度顺序不同，应先考虑相应接口的 axis-order 选项。

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

准备：先确认需要交换的是数据还是显示顺序

本文以 MySQL 8.4 文档中的接口为依据，先用 SRID 0 的平面坐标说明交换。示例只操作会话变量，不创建或更新业务表。它们是供读者执行的小实验，本文没有运行数据库，也没有提供仿造的终端输出。

看到地图上的点偏离预期时，我会先检查原始接口定义：发送方说的是经度在前，还是纬度在前？数据库解析时采用了什么轴顺序？显示层又按什么规则读出？只有确认已经存入的坐标分量确实反了，才考虑交换已有值。仅凭“地图不对”不能推断整列数据都应该交换。

ST_SwapXY 的参数应当是几何值；WKT 文本需要先通过构造函数转换。函数按每对坐标处理，并不会倒转折线的顶点顺序。交换与逆序是不同的几何操作。

用平面点和折线建立最小示例

-- SRID 0 用于平面示意，数值不自动代表经纬度或米。
SET @source_point = ST_GeomFromText('POINT(3 11)', 0);
SET @swapped_point = ST_SwapXY(@source_point);

-- 分别查看两份对象，原变量并未因函数调用自动被覆盖。
SELECT
    ST_AsText(@source_point) AS original_wkt,
    ST_AsText(@swapped_point) AS swapped_wkt;

-- 折线的每一个顶点都交换分量，不倒转顶点顺序。
SET @source_line = ST_GeomFromText('LINESTRING(3 11,7 15,12 4)', 0);
SET @swapped_line = ST_SwapXY(@source_line);
SELECT ST_AsText(@swapped_line) AS swapped_line_wkt;

根据函数规则，上述折线对应的交换后坐标序列为 (11,3)、(15,7)、(4,12)。这是对参数的直接推导，不是声称已观察到数据库输出。请留意第一个顶点仍对应原来的第一个顶点，只是内部两个数字互换。

函数返回几何对象，需要 ST_AsText 等接口转换为可读文本。不要把返回的内部二进制几何直接当成普通字符串来截取修改；手工替换 WKT 中的数字也很难正确覆盖复杂集合与负数等情况。

查看返回对象而不直接覆盖原数据

-- 查看类型和 SRID，用于理解处理对象；此查询没有写入业务表。
SELECT
    ST_GeometryType(@source_line) AS original_type,
    ST_GeometryType(@swapped_line) AS swapped_type,
    ST_SRID(@source_line) AS original_srid,
    ST_SRID(@swapped_line) AS swapped_srid;

-- 交换两次可帮助观察分量对调的含义，不证明业务坐标原本正确。
SELECT ST_AsText(ST_SwapXY(@swapped_line)) AS twice_swapped_wkt;

交换两次恢复分量顺序，是这个操作的代数性质；它不能证明坐标来源、单位或位置含义正确。因此，准备处理真实数据时，应另存原始数据或保留可追溯版本，先明确哪些记录属于同一种已确认的输入问题。不要把一个样本的现象推断为全表规则。

NULL 输入会返回 NULL，语法不完整的几何可能报错。调用方要把“没有几何”与“处理失败”区分开，避免把空结果当成一个正常位置。还应保留原始错误信息，不能统一转成坐标 (0,0) 作为兜底。

地理坐标优先明确轴顺序约定

地理坐标默认轴顺序由空间参考系统定义，不能笼统记成“X 永远等于经度”。以下示例明确外部文本是经度在前；输入与输出都标注 long-lat，避免凭默认值猜测。WKT 构造函数文档列出了轴顺序选项。

-- 外部协议明确使用经度、纬度顺序，解析时显式声明。
SET @geo = ST_GeomFromText(
    'POINT(120 30)', 4326, 'axis-order=long-lat'
);

-- 输出时使用相同约定，避免把显示顺序差异误判为脏数据。
SELECT ST_AsText(@geo, 'axis-order=long-lat') AS longitude_latitude_wkt;

这个例子不需要再调用 SwapXY；再次交换会改变几何的坐标分量。对于已经错误解释、甚至因范围约束而无法构造的输入，更合理的处理通常是从原始 WKT 按正确协议重新解析，而不是试图对一个尚未成功创建的对象交换。设置 SRID 数字本身也不会替坐标做投影运算。

扩展到集合并收尾

-- 集合中的点与折线都包含坐标对，由函数统一交换分量。
SET @source_collection = ST_GeomFromText(
    'GEOMETRYCOLLECTION(POINT(3 11),LINESTRING(2 9,8 6))', 0
);
SELECT ST_AsText(ST_SwapXY(@source_collection)) AS collection_wkt;

-- 释放本例的会话变量引用，不删除任何业务记录。
SET @source_point = NULL, @swapped_point = NULL;
SET @source_line = NULL, @swapped_line = NULL;
SET @source_collection = NULL, @geo = NULL;

我更倾向于把坐标约定写在导入接口边界：字段究竟代表什么、使用哪个 SRS、采用什么文本轴顺序。这样下游通常不需要靠多处 SwapXY 来反复修正。若确实需要交换，保持单一、明确的处理位置，并记录数据来源与处理原因。

ST_SwapXY 会自动保存到表里吗？不会。SELECT 中的函数只产生返回值，持久化需要显式写入语句和业务授权范围。

交换 X/Y 等于把折线倒过来吗？不等于。它交换每个顶点的两个分量，不将顶点数组逆序。

为什么输出数字顺序变化不一定说明数据错误？地理数据的文本表示可能采用不同轴顺序。先对照输入输出选项与 SRS 定义，再决定是否修改实际坐标。

接口细节参考 MySQL ST_SwapXY 文档。