PostgreSQL中md5()函数仅接受text参数并返回32位小写十六进制字符串，但脱敏需统一处理字段顺序、NULL（用COALESCE）、大小写、JSON序列化方式等，否则哈希值不稳定；MD5不适用于安全脱敏，仅适合数据一致性校验。
PostgreSQL 里直接用 md5() 函数就能算字符串的 MD5 值，但「脱敏」不是简单套函数就完事——字段顺序、NULL 处理、大小写、JSON 序列化方式都会让结果不一致，尤其在跨表比对或增量同步场景下容易出错。
PostgreSQL 的 md5() 函数怎么用
它只接受一个 text 类型参数，返回 32 位小写十六进制字符串：
SELECT md5('hello'); -- 返回 '5d41402abc4b2a76b9719d911017c592'常见误用点：
- 传入
bytea或数字类型会报错，必须显式转成text，比如md5(col_name::text) - 空字符串
''和NULL结果不同：md5(NULL)返回NULL，不是空哈希；需要脱敏时得先用COALESCE(col_name, '') - 中文或特殊字符没问题，但要注意数据库编码（UTF8 是安全的）
对整行数据做稳定 MD5（比如用于变更检测）
用 row_to_json() + md5() 是常见做法，但默认不保序，不同 PostgreSQL 版本或查询计划可能导致字段顺序变化，哈希值就不稳定。
正确姿势是强制固定顺序：
- 用
row_to_json(t.*)::text不够可靠，建议改用json_build_object()显式列出字段，比如：md5(json_build_object('id', id, 'name', name, 'email', email)::text) - 如果字段多，可封装成自定义函数（如知识库中
get_md5(row_json JSON, VARIADIC exclude_fields TEXT[])），它按 JSON 原始键序拼接，排除指定字段，且把NULL统一转为空串 - 别用
to_jsonb(t.*)::text，因为jsonb会自动排序 key，破坏原始业务顺序
MD5 用于脱敏时的真实限制
MD5 是单向哈希，不能“解密”，但不等于安全脱敏：
- 短口令、邮箱、手机号等低熵值输入，极易被彩虹表或暴力破解反推原文
- 如果脱敏目的是防内部人员窥探，
md5()不够——应改用带 salt 的pgcrypto函数，比如crypt('pwd', gen_salt('bf')) - 若只是做数据一致性校验（如 ETL 后比对源目标行哈希），
md5()足够快且稳定，但记得统一处理 NULL 和空格（前后 trim） - 注意：MD5 已被密码学界弃用，新系统别用于认证场景；仅限内部校验、临时脱敏、调试用途
真正难的不是调用 md5()，而是确保每次输入完全一致：字段顺序、NULL 表示、编码、换行符、空格。漏掉任意一个，两次计算出来的哈希就对不上。
