必须用 st_within 而非 st_intersects，因后者在边界上会匹配多个面导致结果不可控；需配合 order by st_distance + limit 1 确保稳定匹配，且触发器须为 before insert or update 并处理空坐标与 srid 一致性。
触发器函数里必须用 ST_Within 而不是 ST_Intersects
很多用户一上来就用 ST_Intersects 判断点是否在面内，结果发现行政区划填错了——因为点落在两个区交界线上时，ST_Intersects 会同时匹配多个面，而触发器只取 SELECT ... LIMIT 1 的第一个，结果不可控。正确做法是用 ST_Within，它严格要求点在多边形内部（不含边界），配合 ORDER BY ST_Distance + LIMIT 1 才能稳定选中最贴近的行政中心或主辖区。
实操建议：
- 先确保行政区划表（如
districts）有GIST索引：CREATE INDEX idx_districts_geom ON districts USING GIST (geom);
- 点坐标字段必须是
GEOMETRY(POINT, 4326)类型，不是text或json；若原始是经纬度字段（lon/lat），需在触发器里用ST_SetSRID(ST_MakePoint(NEW.lon, NEW.lat), 4326) - 避免在函数里写
SELECT * FROM districts—— 必须显式列出字段，尤其是id,name,level，否则后续加字段可能让触发器意外失败
触发器必须定义为 BEFORE INSERT OR UPDATE
用 AFTER 触发器无法修改当前行数据，只能发通知或写日志；而自动填充需要直接改 NEW.district_name 这类字段，所以必须是 BEFORE。另外，如果业务允许空坐标跳过填充，得在函数开头加判断：
IF NEW.lon IS NULL OR NEW.lat IS NULL THEN RETURN NEW; END IF;
常见错误现象：
- 用了
AFTER却还在函数里赋值NEW.district_name := ...—— 这些赋值完全无效 - 只定义了
INSERT，但用户更新坐标后行政区没刷新 → 必须同时支持UPDATE，且建议加条件：FOR EACH ROW WHEN (NEW.lon IS DISTINCT FROM OLD.lon OR NEW.lat IS DISTINCT FROM OLD.lat)
- 没声明
RETURNS trigger，PostgreSQL 直接报错：ERROR: function must return type trigger
ST_Transform 在跨坐标系时极易引发性能崩溃
如果你的行政区划 geom 是 2357（北京54）或 4527（西安80），而输入坐标是 WGS84（4326），千万别在触发器里写 ST_Within(ST_Transform(NEW.geom, 2357), ST_Transform(d.geom, 2357)) —— 每次都调 ST_Transform 会让查询无法走索引，10万条数据插入可能从毫秒级变数秒。
正确做法只有两个：
- 统一源头：把行政区划表
geom全部转成4326（用ST_Transform(geom, 4326)更新一次），之后所有操作免转换 - 若无法改源数据，则建一个函数索引：
CREATE INDEX idx_districts_geom_4326 ON districts USING GIST (ST_Transform(geom, 4326));
，并在触发器中对点也用ST_Transform，保持两边 SRID 一致
触发器里不能依赖外部配置表或 HTTP 请求
有人想在触发器里查缓存表、调用 curl 或读取 pg_settings 动态开关，这在 PostgreSQL 中要么不支持（如 curl），要么违反事务一致性（如查另一张未加锁的配置表）。所有逻辑必须封闭在数据库内。
可替代方案：
- 用
pg_conf_load_time()或CURRENT_TIMESTAMP做简单时间控制，但别指望实时开关 - 若真要动态开关，建一张单行配置表（
trigger_config），在触发器里用SELECT enabled FROM trigger_config LIMIT 1，并确保该表有FOR UPDATE锁或设为UNLOGGED减少开销 - 最稳妥的是：把开关逻辑提到应用层，由业务决定是否带
district_name字段插入，触发器只做兜底
复杂点在于地理匹配本身无标准答案——同一个经纬度，在不同比例尺行政区划数据里可能归属不同乡镇。务必确认你用的 districts 数据来源、更新频率和精度，比代码更重要。
