MySQL函数部署报错及修复后功能异常问题求助

本地运行正常的MySQL应用部署后出现报错，修复报错后部分功能仍无法正常使用。本地环境无报错且所有功能正常，附上相关自定义函数代码，恳请协助排查：

DELIMITER $$
--
-- Functions
--
CREATE DEFINER=`root`@`localhost` FUNCTION `kode_automatis` (`kode` INT) RETURNS CHAR(7) CHARSET latin1 COLLATE latin1_swedish_ci  BEGIN
DECLARE kodebaru CHAR(7);
DECLARE urut INT;
 
SET urut = IF(kode IS NULL, 1, kode + 1);
SET kodebaru = CONCAT("TRX", LPAD(urut, 4, 0));
 
RETURN kodebaru;
END;

CREATE DEFINER=`root`@`localhost` FUNCTION `kode_automatis2` (`kode` INT) RETURNS CHAR(7) CHARSET latin1 COLLATE latin1_swedish_ci  BEGIN
DECLARE kodebaru CHAR(7);
DECLARE urut INT;
 
SET urut = IF(kode IS NULL, 1, kode + 1);
SET kodebaru = CONCAT("TRF", LPAD(urut, 4, 0));
 
RETURN kodebaru;
END;

DELIMITER ;

排查方向 #

• DEFINER权限限制：函数定义的执行权限是root@localhost，但部署环境的应用数据库账号通常不是这个账号，且生产环境一般不会开放root权限。调用函数时会校验DEFINER的权限，若该账号不存在或权限不足，会导致函数执行失败。解决方式：修改函数DEFINER为部署环境实际使用的账号，或者添加SQL SECURITY INVOKER让函数使用调用者权限，示例：

  CREATE FUNCTION `kode_automatis` (`kode` INT) RETURNS CHAR(7) CHARSET latin1 COLLATE latin1_swedish_ci SQL SECURITY INVOKER BEGIN
  -- 函数逻辑不变
  END;
  

• 字符集/排序规则不匹配：函数指定了latin1字符集和latin1_swedish_ci排序规则，若部署环境的数据库、表或应用连接字符集为utf8/utf8mb4，可能出现字符转换异常，导致生成的编码（如TRX0001）存储或读取时乱码、截断，影响依赖该编码的功能。解决方式：将函数字符集改为与部署环境一致的utf8mb4，或者确保应用连接字符集与函数定义匹配。

• 参数合法性问题：本地调用时传入的kode是合法INT值，但部署环境可能传入非INT类型（或转换失败的字符串）、超出INT范围的值，导致urut计算异常，生成的kodebaru不符合预期。可以在函数内增加参数校验，比如：

  SET urut = IF(kode IS NULL OR kode < 0 OR kode > 9999, 1, kode + 1);
  

  （注：LPAD(urut,4,0)最多支持4位，urut超过9999会生成超过7位的字符，导致返回值被截断）

• 函数部署不完整：部署时可能未正确创建函数（比如脚本执行中断），导致部分功能调用时找不到函数对象。可以登录部署环境数据库，执行SHOW FUNCTION STATUS LIKE 'kode_automatis%';检查函数是否存在、定义是否正确。

内容的提问来源于stack exchange，提问作者Syahrul Nizam