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_* 前缀函数。
MySQL8 CRM Schema Design Expert
下载
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
- 不要全局替换
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 解析器变严格了，尤其对多边形闭合性、环方向、自相交校验增强。
- 典型坑：
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 不支持空间列前缀索引）
ST_AsText 调用没补 SRID 参数，或者迁移脚本里用 mysqldump --compatible=mysql40 导出的 WKT 格式在 8.0 下直接失效。得一块一块切，每改一点就跑一次 ST_IsValid 和 EXPLAIN。 
