MySQL ST_Buffer 怎样为几何对象生成缓冲区

第一次把地图上的“附近范围”放进 MySQL 时，我最容易犯的错是把 ST_Buffer 当成“给坐标加减一个数”。它真正做的事情更具体：给定几何对象 g 和距离 d，返回同一空间参考系统中，距离该对象不超过 d 的几何结果。

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

下面按输入契约、函数调用、策略参数、坐标系边界和接入方式展开。示例是原创教学 SQL，未连接数据库执行；文中的几何结果描述用于解释 API 语义，不代表线上查询截图或性能测试。

先确定缓冲区的几何含义和距离单位

可以先把 ST_Buffer 理解成一条空间边界：输入是 Point、LineString、Polygon 或相应的集合，距离 d 决定边界向外扩展多少。返回值仍然使用输入几何的 SRS，因此距离的含义不能脱离 SRID 单独讨论。

在笛卡尔 SRS 中，距离通常按该平面坐标系的单位解释；在地理 SRS 中，MySQL 对 Point 有额外的地理缓冲支持，距离参数按该 SRS 的距离单位处理。不要看到经纬度数字就直接把“0.01”当成固定公里数。

用 Point、LineString 和 Polygon 组织最小调用

先用没有 SRID 的笛卡尔 WKT 建立最小概念，重点观察几何类型和距离参数。Point 的正距离会得到包围点的区域；LineString 会向线段两侧扩展；Polygon 则会形成外扩后的面。

-- 使用独立变量演示三种几何类型，不修改业务表中的空间列。
SET @point = ST_GeomFromText('POINT(10 10)');
SET @line = ST_GeomFromText('LINESTRING(0 0, 10 0, 10 5)');
SET @polygon = ST_GeomFromText(
    'POLYGON((0 0, 20 0, 20 10, 0 10, 0 0))'
);

-- d=2 表示在当前几何 SRS 中向外计算距离为 2 的缓冲区。
SELECT ST_AsText(ST_Buffer(@point, 2)) AS point_buffer,
       ST_AsText(ST_Buffer(@line, 2)) AS line_buffer,
       ST_AsText(ST_Buffer(@polygon, 2)) AS polygon_buffer;

这里的 ST_AsText 只是为了把几何对象转换成可阅读的 WKT。实际业务中可以继续把 ST_Buffer 的几何结果交给空间关系函数、写入带 SRID 的空间列，或者再序列化为 GeoJSON。

有三个边界值得单独记住：

• d = 0 时，官方语义是返回与输入相同的几何对象，不会凭空产生外扩区域。
• 笛卡尔 SRS 下，负距离主要用于 Polygon、MultiPolygon 及包含这些类型的集合；对 Point、LineString 等类型使用负距离会触发参数错误。
• 空几何输入会得到空几何，不能把空结果直接当成“附近没有对象”这一业务结论。

用 ST_Buffer_Strategy 控制点线外形

默认缓冲外形通常已经够用，但地图展示、碰撞区域或几何清理场景往往需要控制圆角、方角和端点。MySQL 提供 ST_Buffer_Strategy 生成策略字节串，再把它作为 ST_Buffer 的可选参数传入。

-- 点策略决定 Point 或 MultiPoint 缓冲是圆形还是方形。
SET @point_square = ST_Buffer_Strategy('point_square');

-- 连接策略决定折线拐角的连接方式，端点策略决定折线两端的收口方式。
SET @join_miter = ST_Buffer_Strategy('join_miter');
SET @end_flat = ST_Buffer_Strategy('end_flat');

-- 参数顺序可以不同，但同一类策略不要重复传入。
SELECT ST_AsText(ST_Buffer(
           ST_GeomFromText('POINT(0 0)'), 2, @point_square
       )) AS square_point_buffer,
       ST_AsText(ST_Buffer(
           ST_GeomFromText('LINESTRING(0 0, 5 0, 5 5)'),
           1, @end_flat, @join_miter
       )) AS styled_line_buffer;

点策略只应该用于 Point 或 MultiPoint；连接策略适用于线和面；端点策略适用于 LineString 与 MultiLineString。一个常见误区是把三类策略当成“任意字符串选项”，实际上它们必须由 ST_Buffer_Strategy 产生，且同一类型不能重复出现。

对于 point_circle、join_round、join_miter 和 end_round，还可以给出正数的 points_per_circle。数值越大，圆弧近似通常越细，但生成几何的复杂度也可能上升。它是形状精度与结果规模的参数，不是“让查询一定更快”的开关。

笛卡尔 SRS 和地理 SRS 不要混用经验

如果数据列带有地理 SRS，先确认输入几何类型。MySQL 8.4 对地理 SRS 的 Point 缓冲有专门边界：距离不能为负，指定策略也可能不适用；对非 Point 几何直接使用地理 SRS 的 ST_Buffer，会遇到未实现或参数边界。

-- 示例只表达输入契约：经度在前、纬度在后，SRID 明确为 4326。
SET @location = ST_GeomFromText(
    'POINT(116.40 39.90)',
    4326,
    'axis-order=long-lat'
);

-- 地理 Point 的正距离按该 SRS 的距离单位解释；不要把 500 当作 500 度。
SELECT ST_AsText(ST_Buffer(@location, 500)) AS geographic_point_buffer;

-- 负距离和点策略不应直接套用到这个地理 Point 示例。
-- 先按数据契约决定是否需要转换到合适的笛卡尔投影再计算。

这也是空间函数排障时最值得先看的三项：输入几何的类型、SRID 以及距离单位。错误信息往往只是最后一层表现，真正的原因可能是把经纬度点、平面距离和面缓冲策略放进了同一次调用。

把缓冲结果接入查询或存储

ST_Buffer 适合先生成一个空间对象，再把它交给后续关系判断。比如服务区查询可以把用户输入的 Point 生成缓冲区，然后用空间关系函数筛选候选对象。这里关注的是数据流，不把示例包装成执行计划或真实性能证明。

-- 生成业务范围时保留变量，便于后续谓词复用和问题复盘。
SET @service_center = ST_GeomFromText('POINT(10 10)');
SET @service_area = ST_Buffer(@service_center, 5);

-- location 是带相同空间约定的空间列；关系函数的参数方向要按业务语义确认。
SELECT id, name
FROM place_demo
WHERE ST_Within(location, @service_area)
ORDER BY id;

-- 只在需要文本传输时序列化，存储层尽量保留空间类型。
SELECT ST_AsText(@service_area) AS area_wkt;

如果结果要跨服务传输，可以使用官方支持的 GeoJSON 转换函数；如果结果只在数据库内参与空间关系判断，保留 Geometry 往往更直接。无论选择哪种方式，都要记录输入 SRS、距离单位、是否使用策略以及空几何处理策略。

我通常会把这些字段和任务一起写进排障记录：原始几何类型、SRID、距离 d、策略名称、函数返回是否为空、后续谓词和序列化格式。这样下次遇到“缓冲区偏大”或“结果为空”，可以先复现输入契约，而不是只盯着地图上的一块颜色。

常见问题

ST_Buffer 的距离单位是什么？由输入几何的 SRS 决定。笛卡尔坐标系按平面单位解释，地理 SRS 有自己的距离语义；不要只根据数字长短猜单位。

为什么 Polygon 可以用负距离，Point 不行？负距离表达的是对面几何的内缩，MySQL 不把它泛化到所有几何类型；对 Point、LineString 等类型会落入参数错误边界。

points_per_circle 越大越好吗？不一定。它会影响圆弧近似和结果复杂度，应结合地图缩放、存储大小和后续空间运算选择。

可以直接对经纬度 Point 使用任意 LineString 策略吗？不能。地理 SRS 对 Point 的缓冲和策略有专门限制；需要面或线缓冲时，应先确认目标空间参考系和转换方案。

为什么生成了缓冲区却查不到对象？先检查空间列与缓冲结果的 SRID、关系函数的参数方向、距离单位和空几何情况，再看数据本身是否真的落在范围内。

参考资料：MySQL 8.4 Spatial Operator Functions、Spatial Function Reference、GIS WKT Functions。本文示例只用于说明调用关系，正式环境请先在隔离库确认空间参考系、数据来源和结果规模。