自定义函数中文变问号是因函数体被错误字符集解码所致,导出需用--default-character-set=utf8mb4,导入前须SET NAMES utf8mb4,且调用时连接字符集必须匹配。

自定义函数体里的中文变问号,本质是函数定义被错误解码
MySQL自定义函数(CREATE FUNCTION)中如果包含中文注释、字符串常量或提示文本,迁移后显示为????,不是函数逻辑错了,而是函数体的 SQL 定义在存储时被按错误字符集解析过一遍。函数体本身作为元数据存进 mysql.proc 表,而该表的 body 字段类型是 longblob,不直接存字符——真正起作用的是创建函数时客户端连接的 character_set_client 和服务端执行时的 character_set_connection。一旦这两者不一致,函数体字符串就会被“双解码”或“错位解码”,后续调用时返回的仍是损坏内容。
迁移前必须导出函数时显式指定 --default-character-set
用 mysqldump 导出含中文的自定义函数,不加字符集参数等于放弃抢救。默认行为会按当前会话的 character_set_client 读取函数定义,而这个值可能已是 latin1(尤其老库),导致导出的 SQL 文件里函数体已变成乱码字节。
- 正确做法:导出命令开头必须带
--default-character-set=utf8mb4,且它要放在所有其他参数之前(位置敏感) - 验证导出文件是否可信:用
head -n 50 your_dump.sql | grep -A5 "CREATE FUNCTION"看函数体内的中文是否可读;再用file -i your_dump.sql确认是charset=utf-8 - 如果源库确实是
latin1存的中文函数体(极少见但存在),不能直接改参数重导,得先连回原库,用SET NAMES latin1;后再SHOW CREATE FUNCTION func_name;手动复制定义
目标库导入时 SET NAMES utf8mb4 必须在 CREATE FUNCTION 之前执行
即使 dump 文件没问题,导入时也容易踩坑:MySQL 命令行客户端默认继承终端 locale,而很多 Linux 终端是 en_US.UTF-8,但若目标 MySQL 实例的 character_set_server 是 latin1,那么没设会话变量就执行 CREATE FUNCTION,函数体仍会被当 latin1 解析。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 安全导入流程:先连上目标库,立刻执行
SET NAMES utf8mb4;(等价于同步设置character_set_client/character_set_connection/character_set_results) - 然后才 source 导出文件,或逐条执行
CREATE FUNCTION语句 - 验证函数体是否完好:查
mysql.proc表的body字段(需有权限),或更简单——用SHOW CREATE FUNCTION func_name;看返回结果里的中文是否清晰
函数内嵌字符串常量的字符集由连接决定,不是由函数定义时固定
这是最容易忽略的一点:函数体里写的 RETURN '你好'; 这类字符串,其编码解释权不在函数创建时,而在于每次调用时的会话连接设置。也就是说,同一个函数,在 SET NAMES latin1 的会话里调用,返回的可能是乱码;换到 SET NAMES utf8mb4 就正常。
- 不要试图在函数定义里用
CONVERT('你好' USING utf8mb4)来“固化”编码——这毫无意义,CONVERT只在运行时起作用,且依赖当前连接字符集 - 真正可靠的方案是:确保所有调用该函数的应用连接串都带
characterEncoding=utf8mb4(JDBC)、--default-character-set=utf8mb4(命令行)或对应驱动设置 - 如果函数要返回多语言文本,建议调用方统一处理编码转换,而非把责任推给函数内部
函数体乱码一旦写进 mysql.proc,就无法靠 ALTER FUNCTION 修复——MySQL 不允许直接修改函数体,只能删了重建。所以迁移时那一步 SET NAMES utf8mb4 不是可选项,是生死线。










