MySQL开启binlog后要求函数必须声明确定性属性,否则报ERROR 1418;需在RETURNS后、BEGIN前明确标注DETERMINISTIC、NO SQL或READS SQL DATA之一,且声明须与函数实际行为一致。

不是为了“让函数跑得更快”,而是 MySQL 在开启 binlog 后,必须能判断这个函数在主从复制中是否安全——不声明,就拒绝创建。
报错 ERROR 1418 的真实原因
只要开启了 binlog(默认主从、备份、PITR 场景都会开),MySQL 就不允许“黑盒函数”:它无法预知你的函数会不会返回随机值、读取当前时间、修改数据,或者依赖会变的上下文。所以建函数时必须用且仅用以下之一标注:
-
DETERMINISTIC:输入相同,输出一定相同(如UPPER()、拼音首字母函数) -
NO SQL:函数体里一行SELECT/INSERT都没有(纯计算) -
READS SQL DATA:只执行SELECT,不改数据(比如查字典表转码)
漏写、写错位置(必须紧接 RETURNS 后、BEGIN 前)、或写了多个(如同时写 DETERMINISTIC READS SQL DATA),都会触发 ERROR 1418。
DETERMINISTIC 不等于“能走索引”
很多人以为加了 DETERMINISTIC 就能让 WHERE my_func(col) = 'X' 走索引,其实不是:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- MySQL 8.0.13+ 才支持函数索引,语法必须是
CREATE INDEX idx ON t ((my_func(col)))(注意双括号) - 即使加了
DETERMINISTIC,优化器也不会自动为函数结果建索引 - 如果函数内部调用了
NOW()、RAND()、UUID()或子查询,声明DETERMINISTIC本身就会被 MySQL 拒绝(语义矛盾)
触发器里调用自定义函数必须显式声明
在 BEFORE INSERT 或 BEFORE UPDATE 触发器中调用自定义函数时,MySQL 会做双重校验:既要函数本身声明合法,又要求该声明与调用上下文兼容。
- 哪怕函数只是把中文转成首字母(如“李四”→“LS”),也必须写
DETERMINISTIC - 不能只写
READS SQL DATA,更不能省略——触发器场景下,MySQL 默认按最严策略检查 - 如果函数体里有
CONVERT(col USING gbk)或正则替换,只要输入确定、输出固定,仍算满足DETERMINISTIC语义
最容易被忽略的一点:托管数据库(如阿里云 RDS、AWS RDS)通常禁止修改 log_bin_trust_function_creators,临时绕过这条路根本走不通;而一旦函数声明错误,连 DROP FUNCTION 都可能失败——因为元数据已损坏。所以第一遍写,就得把声明位置、类型、内部逻辑三者对齐。










