MySQL 8.0 升级后 GIS 兼容性断裂主因是语义层重构：强制要求空间列显式声明 SRID（如 POINT SRID 4326），移除 GeomFromText 等非标函数（须改用 ST_GeomFromText(..., 4326)），WKT 解析更严格（需闭合多边形），且空间索引失效常因 SRID 不一致或函数包裹导致。

ST_GeomFromText

这类函数报错，基本可以确定是 5.7 → 8.0 升级后 GIS 兼容性断裂导致的，不是配置或权限问题，而是语义层重构。

建表时没声明 SRID 直接报错 ER_SRS_NOT_FOUND

MySQL 8.0 要求所有空间列必须显式绑定 SRID，哪怕你只是存个 POINT。旧表里 location POINT NOT NULL 这种写法在 8.0 启动就会失败。

• 错误信息：ERROR 3641 (HY000): A non-empty SRID value is required for column 'location'
• 修复方式：用 ALTER TABLE t MODIFY location POINT SRID 4326 NOT NULL; 补上 SRID；注意不能只改 DEFAULT，必须重定义列类型
• 如果原数据混了不同 SRID（比如部分是 4326、部分是 0），先用 SELECT ST_SRID(location) FROM t GROUP BY ST_SRID(location); 检查分布，再统一转换
• SRID 选 4326 是最安全的起点，但别硬编码进业务逻辑——后续要用 ST_Transform() 做投影时才体现差异

GeomFromText 等旧函数调用直接报 “FUNCTION does not exist”

MySQL 8.0 彻底移除了 GeomFromText、AsText、Distance 等非标准函数，只保留 SQL/MM 标准的 ST_* 前缀函数。

• 不要全局替换 Distance → ST_Distance：它在 8.0 是保留字，若字段名也叫 distance，会语法冲突
• 正确映射示例：GeomFromText('POINT(1 1)') → ST_GeomFromText('POINT(1 1)', 4326)（必须补 SRID 参数）
• IsWithin(a, b) → ST_Within(a, b)，但要注意：5.7 中 IsWithin 对无效几何体可能返回 NULL，而 8.0 的 ST_Within 会直接报错 ER_GIS_INVALID_DATA
• ORM 层（如 MyBatis XML 或 Hibernate @Formula）若硬编码了旧函数，必须改代码，数据库兼容层兜不住

WKT 字符串解析失败，报 ERROR 3617: Invalid GIS data provided

不是字符串格式错了，是 MySQL 8.0 的 WKT 解析器变严格了，尤其对多边形闭合性、环方向、自相交校验增强。

MySQL8 CRM Schema Design Expert

面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。

下载

• 典型坑：POLYGON((0 0,1 0,1 1,0 1)) 缺少首尾点重合，在 5.7 可插入，8.0 直接拒收
• 验证方法：SELECT ST_IsValid(ST_GeomFromText('POLYGON((0 0,1 0,1 1,0 1))', 4326)); 若返回 0，说明构造失败
• 修复方案：补全闭合点 → POLYGON((0 0,1 0,1 1,0 1,0 0))；或用 ST_MakeValid() 自动修正（但结果可能不是你预期的几何形态）
• 批量修复建议用正则 + sed：匹配 POLYGON(([^)]+)) 并在末尾加首坐标，但注意嵌套结构（如 MULTIPOLYGON）需更谨慎处理

空间索引不走、EXPLAIN 显示 type=ALL

即使加了 SPATIAL KEY，查询仍全表扫描，大概率是函数包裹或 SRID 不一致导致优化器放弃使用索引。

• 常见错误写法：WHERE ST_Distance_Sphere(location, POINT(120 30)) —— 这个表达式无法下推到索引层，MySQL 必须算完整张表的距离
• 正确姿势：先用 ST_Within 或 ST_Intersects 做粗筛，再用 ST_Distance_Sphere 精排：WHERE ST_Within(location, ST_Buffer(ST_Point(120, 30), 0.01)) AND status = 1
• 确保查询中所有几何参数都带 SRID：ST_Point(120, 30) 默认 SRID=0，和 location SRID 4326 不匹配，会触发 ER_SRID_MISMATCH 或静默降级为全表扫
• 检查索引是否生效：SHOW INDEX FROM t; 看 Seq_in_index 是否为 1，且 Sub_part 为空；若为非空，说明建索引时用了前缀（8.0 不支持空间列前缀索引）

真正卡住人的地方，往往不是“不知道要改什么”，而是改了一处，另一处隐性依赖崩了——比如修好了 SRID 声明，但 ORM 生成的 ST_AsText 调用没补 SRID 参数，或者迁移脚本里用 mysqldump --compatible=mysql40 导出的 WKT 格式在 8.0 下直接失效。得一块一块切，每改一点就跑一次 ST_IsValid 和 EXPLAIN。