MySQL Spatial字段在GORM中必须用string或[]byte接收，不可直接用geometry.Point等原生类型；推荐ST_AsText/ST_GeomFromText函数组合操作WKT，WHERE条件需用ST_函数包裹。
MySQL Spatial字段在GORM中必须用string或自定义类型接收，不能直接用geometry等Go原生类型
MySQL的POINT、POLYGON等空间类型在底层以WKB（Well-Known Binary）或WKT（Well-Known Text）格式存储，但GORM v1.23+ 默认不识别这些类型。如果你在struct里写Location geometry.Point或Area *geometry.Polygon，GORM会报unsupported scan type或直接panic。
实际可行的做法只有两种：
- 用
string字段接收WKT（如"POINT(121.47 31.23)"），适合读写简单、调试友好、且业务层不频繁做空间计算的场景 - 用
[]byte接收WKB（二进制），再配合github.com/twpayne/go-geom/encoding/wkb解析，适合需要高性能、批量空间关系判断（如ST_Within）的场景 - 切勿尝试用
sql.Scanner实现Scan/Value方法去“包装”geometry.Point——MySQL驱动返回的是[]byte或string，GORM在Scan阶段已按字段类型做了预处理，自定义类型若未精确匹配底层返回类型，会静默失败
ST_AsText和ST_GeomFromText是GORM操作Spatial最稳的SQL函数组合
GORM不支持POINT字面量语法（如POINT(1,1)），也不能直接把Go struct转成WKT传入Create。必须显式调用MySQL空间函数：
- 插入时用
db.Exec("INSERT INTO places (name, location) VALUES (?, ST_GeomFromText(?))", "Shanghai", "POINT(121.47 31.23)") - 查询时用
db.Raw("SELECT name, ST_AsText(location) as location_wkt FROM places").Scan(&results)，确保results中对应字段是string - WHERE条件中必须用函数包裹：比如查某点5km内地点，得写
db.Where("ST_Distance(location, ST_GeomFromText(?)) ；注意<code>ST_Distance单位是米（需MySQL 5.7.6+，且字段有SRID=4326） - 别依赖
db.Where("location = ST_GeomFromText(?)", ...)做相等判断——WKB二进制可能因精度/序列化方式不同导致!=，应改用ST_Equals
SRID必须显式设置，否则ST_Distance等函数返回NULL
MySQL 5.7+ 要求空间字段声明SRID（如POINT SRID 4326），否则所有空间关系函数（ST_Within、ST_Distance、ST_Intersects）都会返回NULL，且无任何错误提示。
建表时务必这样写：
CREATE TABLE places ( id BIGINT PRIMARY KEY, name VARCHAR(100), location POINT SRID 4326, SPATIAL INDEX(location) );
如果已有表没设SRID，不能用ALTER COLUMN ... SET SRID=4326（MySQL不支持），只能：
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理（CRM）系统设计、评审、优化或生成数据库模式时，应使用此项技能。
- 新增字段
location_new POINT SRID 4326 - 用
UPDATE places SET location_new = ST_SetSRID(location, 4326) - 删旧字段、重命名新字段
另外，ST_GeomFromText("POINT(1 1)")默认SRID=0，必须写成ST_GeomFromText("POINT(1 1)", 4326)才匹配字段SRID。
用db.Session(&gorm.Session{PrepareStmt: true})避免WKT字符串被自动转义
当WKT含括号、空格、逗号（如"POLYGON((0 0,1 0,1 1,0 1,0 0))"），GORM默认Prepare模式会把?参数当成纯字符串，MySQL驱动可能误加引号或转义，导致ST_GeomFromText解析失败，报错Invalid GIS data provided to function st_geomfromtext。
解决方法是禁用Prepare（开发/测试环境可接受）：
db.Session(&gorm.Session{PrepareStmt: false}).Exec(
"INSERT INTO areas (name, shape) VALUES (?, ST_GeomFromText(?))",
"block_a",
"POLYGON((121.47 31.23,121.48 31.23,121.48 31.24,121.47 31.24,121.47 31.23))"
)
生产环境若坚持用Prepare，就得把WKT拼进SQL字符串（不推荐），或改用[]byte + WKB + ST_GeomFromWKB绕过文本解析。
空间索引是否生效、WKT坐标顺序（经度在前还是纬度在前）、以及MySQL版本对地理距离函数的支持程度，这几个点一旦出问题，现象都是“查询结果为空但无报错”，最容易卡住半天。
