MySQL ST_AsGeoJSON 怎样控制几何输出的小数位

可以。ST_AsGeoJSON() 的第二个参数就是 max_dec_digits：它限制坐标最多保留多少位小数，并对输出坐标进行四舍五入。比如传入 2，经纬度会按两位小数输出；传入 0，则输出整数坐标。

容易混淆的是第三个参数 options。它是位掩码，用来控制 bbox 或 CRS 等附加信息，不负责坐标小数位。实际使用时把“坐标展示精度”和“GeoJSON 附加字段”分开传，就不会把参数顺序写反。

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

第二参数才是小数位控制器

函数签名可以记成 ST_AsGeoJSON(g [, max_dec_digits [, options]])。第一个参数是几何值，第二个参数控制坐标小数位，第三个参数才是附加选项。下面用同一个点演示三种输出策略：

-- 第二参数分别控制坐标小数位；第三参数暂时使用默认值 0
SELECT
  ST_AsGeoJSON(ST_GeomFromText('POINT(121.473701 31.230416)'), 0) AS digits_0,
  ST_AsGeoJSON(ST_GeomFromText('POINT(121.473701 31.230416)'), 2) AS digits_2,
  ST_AsGeoJSON(ST_GeomFromText('POINT(121.473701 31.230416)'), 5) AS digits_5;

按文档定义，结果会分别接近 [121, 31]、[121.47, 31.23] 和 [121.4737, 31.23042]。这里的重点不是死记某一组数，而是确认第二参数改变的是坐标数字的输出位数，并且会触发舍入。

小数位参数如何选

max_dec_digits 的最小值是 0。不传这个参数时，MySQL 使用很大的默认上限，因此通常会保留输入坐标中的更多小数。接口需要固定响应格式时，建议根据消费端的实际需求明确传值：

不要把这个参数理解成“修改表里的几何值”。它只影响本次 GeoJSON 序列化出来的坐标文本；原始几何列仍然是数据库中的空间值。若接口输出会被再次导入或参与测距、相交等计算，最好保留足够位数，或者直接在服务层区分“展示接口”和“计算接口”。

options 负责附加信息，不负责小数位

第三参数是位掩码，默认值为 0。常用值包括：1 添加 bounding box，2 添加短格式 CRS URN，4 添加长格式 CRS URN；组合值可以按位相加，例如 5 表示 bbox 加长格式 CRS。

-- 第二参数 3 表示坐标保留三位小数；第三参数 1 只请求 bbox
SELECT ST_AsGeoJSON(
  ST_GeomFromText('LINESTRING(121.4701 31.2301,121.4809 31.2408)'),
  3,
  1
) AS geojson_with_bbox;

-- 这里的 1 不是“一位小数”，而是 options 的 bbox 标志位

因此，下面两种写法表达的是不同意图：

-- 只控制坐标小数位为 2 位
SELECT ST_AsGeoJSON(geom, 2);

-- 坐标保留 2 位，同时请求 bbox
SELECT ST_AsGeoJSON(geom, 2, 1);

NULL、非法参数与几何精度边界

如果任意参数是 NULL，函数返回 NULL；如果非 NULL 参数无效，则会报错。应用层不要把缺失的精度配置随意拼成字符串，应该在 SQL 参数绑定或默认配置中明确它是否为 NULL。

还要区分三个概念：

• 原始几何精度：表中空间值本身保存了什么坐标。
• 序列化精度：max_dec_digits 让 GeoJSON 文本输出多少位小数。
• 坐标系声明：options 中的 CRS 标志是否在输出中附加 CRS 信息。

把输出限制为两位小数，并不等于把原始几何永久改成两位小数；同样，添加 CRS 也不会替你完成坐标系转换。需要转换坐标系时，仍应使用对应的空间参考系统和转换流程，不能只靠 options。

接口设计时的实用写法

如果一个接口只是把地图要素返回给浏览器，可以在查询中把展示策略写清楚；如果同一数据还要供空间分析使用，则不要复用已经舍入过的 GeoJSON 作为唯一数据源：

-- 展示接口：固定两位小数，响应结构更稳定
SELECT id, ST_AsGeoJSON(geom, 2, 0) AS geometry
FROM place;

-- 分析接口：保留更多坐标细节，不额外添加 bbox/CRS
SELECT id, ST_AsGeoJSON(geom, 8, 0) AS geometry
FROM place;

-- 查询中的参数应绑定或来自白名单配置，避免把用户输入直接拼成 SQL

如果前端还需要快速定位范围，可以考虑在展示接口中使用 options=1 添加 bbox，但要同步确认客户端能正确读取该字段。精度参数和附加字段是两个独立的接口契约，建议在接口文档中分别写明。

常见问题

ST_AsGeoJSON 的第二参数写成 2 是不是表示 options=2？

不是。在只有两个参数时，第二个位置是 max_dec_digits，表示最多两位小数。只有把它放到第三个位置，才是 options 的值。

max_dec_digits 会修改数据库里的 geom 吗？

不会。它控制当前函数调用产生的 GeoJSON 坐标文本。要持久化修改空间值，需要另行设计数据更新操作。

为什么传入 options=1 后看不到小数位变化？

因为 1 在第三参数位置表示添加 bbox。坐标小数位仍由第二参数控制，例如 ST_AsGeoJSON(geom, 2, 1) 才是“两位小数加 bbox”。

减少小数位能不能代替坐标系转换？

不能。减少小数位只是舍入输出数字，CRS 选项只是附加坐标系标识；两者都不是坐标系转换。

记住一句话：第二参数管坐标小数位，第三参数管 GeoJSON 附加选项；输出更短不等于原始几何被修改。