必须手写immutable pl/pgsql函数实现拼音首字母同步，因tsvector_update_trigger仅支持全文检索分词、不支持拼音转换，且触发器要求函数声明为immutable或stable才能执行。
不能直接用内置触发器函数实现拼音首字母同步，必须写自定义 PL/pgSQL 函数，并确保它被声明为 IMMUTABLE 或 STABLE；否则触发器会拒绝执行或报错 ERROR 1418 类错误。
为什么 tsvector_update_trigger 对拼音完全无效
这个函数专为 tsvector 类型设计，底层调用 to_tsvector()，只处理分词、停用词、词干等文本搜索逻辑，对中文拼音转换零支持。你传入 'chinese' 配置也没用——to_tsvector('chinese', '张') 返回的是分词结果（如 '张':1），不是拼音首字母 'Z'。
-
tsvector_update_trigger不接受自定义转换逻辑，参数里塞不了拼音函数 - 即使装了
zhparser，它输出仍是词位，不是拼音字符串 - 试图在触发器里调用
to_tsvector()拼音字段会失败：类型不匹配（tsvectorvstext）
必须手写 PL/pgSQL 函数并标记 IMMUTABLE
PostgreSQL 触发器中调用的函数，若涉及字符串计算且无外部依赖（如查表、调用 pg_catalog 以外函数），必须显式声明为 IMMUTABLE，否则插入/更新会报错：
ERROR: function cannot be called directly in trigger context unless declared IMMUTABLE or STABLE
- 函数体里禁止出现
SELECT、INSERT、PERFORM等访问数据库的操作 - 所有拼音映射必须硬编码进函数（如
CASE WHEN unicode(c) BETWEEN 19968 AND 40869 THEN 'A' ...），不能查hz_pinyin_first表 - 输入为
TEXT，输出为TEXT，空值用COALESCE(input, '')统一处理 - 示例函数头必须这样写：
CREATE OR REPLACE FUNCTION get_py_initial(input TEXT) RETURNS TEXT AS $$ ... $$ LANGUAGE plpgsql IMMUTABLE;
触发器绑定时必须用 BEFORE INSERT OR UPDATE
只有 BEFORE 触发器才能修改 NEW 行的字段值。拼音字段（比如 py_initial）需在数据写入前算好并赋值，否则 AFTER 触发器只能“看”不能“改”。
- 触发器语法必须是：
EXECUTE FUNCTION get_py_initial(NEW.name)，不能写成SELECT get_py_initial(NEW.name) - 字段赋值写法：
NEW.py_initial := get_py_initial(NEW.name); - 多字段拼接拼音首字母？别用
||连接函数调用——每个函数调用都得单独写，避免空值导致整串变NULL - 验证是否生效：插入后立刻查
SELECT name, py_initial FROM table WHERE id = lastval();，不要依赖日志或延迟观察
中文字符集与边界情况必须手动覆盖
PostgreSQL 默认按 UTF-8 处理字符串，但拼音首字母判断依赖汉字 Unicode 区间（\u4e00–\u9fff）和 GBK 编码首字节（0xB0–0xF7）。纯 UTF-8 下无法直接取 GBK 字节，所以必须用 unicode() + 区间判断。
- 一级汉字（常用字）Unicode 范围是 19968–40869，但生僻字、扩展区 A/B 字符也要覆盖，否则返回空
- 英文字母直接
UPPER()，数字、空格、标点统一返回空字符串（''），避免拼音字段污染 - 全角字符（如 、。）需先用
translate(input, ' 。！？', ' .!?')转半角，再处理——这步必须写进函数体 - 函数内严禁用
unaccent()或citext，它们不是IMMUTABLE，触发器会拒绝调用
真正难的不是写函数，而是让 PostgreSQL 相信这个函数“不会变”——哪怕你硬编码了 500 行 CASE，也得加 IMMUTABLE 声明，且不能漏掉任何可能的输入分支。少一个 ELSE ''，遇到未定义字符就返回 NULL，整个拼音字段就废了。
