MySQL 自定義函數開發指南：從語法到權限陷阱全解析

創建函數完整示例

DELIMITER $$
DROP FUNCTION IF EXISTS `onlineFunction`$$
CREATE FUNCTION `onlineFunction`(rrrr VARCHAR(50))
RETURNS VARCHAR(255)
BEGIN
    IF (rrrr = 'online') THEN
        RETURN '上線';
    END IF;
END$$
DELIMITER ;

關鍵語法詳解

常見錯誤與解決

錯誤 1064：語法錯誤靠近 'end'

原因： 未設置 DELIMITER，函數體內分號被誤認為創建語句結束。

修正： 必須在 CREATE FUNCTION 前設置 DELIMITER $$，結束後恢復。

錯誤 1304：函數已存在

修正： 使用 DROP FUNCTION IF EXISTS `func_name` 先清理。

權限陷阱：log_bin_trust_function_creators

啟用二進制日志（主從復制環境）時，創建函數/觸發器需要 SUPER 權限，否則報錯：

ERROR 1419 (HY000): You do not have the SUPER privilege and binary logging is enabled
(you *might* want to use the less safe log_bin_trust_function_creators variable)

三種解決方案

1. 使用 SUPER 權限賬號創建（推薦，最安全）
2. 開啟全局信任變量（有安全風險，不推薦生產環境）

   -- 臨時生效（重啟失效）
   SET GLOBAL log_bin_trust_function_creators = 1;
   
   -- 永久生效：my.cnf [mysqld] 區段添加
   log_bin_trust_function_creators = 1

3. 關閉二進制日志（僅適用於非復制從庫）

   # my.cnf 註釋掉
   # log-bin=mysql-bin
   # binlog_format=mixed

函數體進階語法

變量聲明與賦值

DECLARE var_name TYPE [DEFAULT value];
SET var_name = expr;
SELECT col INTO var_name FROM table WHERE ...;

流程控制結構

-- IF-ELSEIF-ELSE
IF condition THEN
    statements;
ELSEIF condition THEN
    statements;
ELSE
    statements;
END IF;

-- CASE
CASE expr
    WHEN value1 THEN statements;
    WHEN value2 THEN statements;
    ELSE statements;
END CASE;

-- LOOP / REPEAT / WHILE
WHILE condition DO
    statements;
END WHILE;

游標使用

DECLARE cur CURSOR FOR SELECT col FROM table;
DECLARE CONTINUE HANDLER FOR NOT FOUND SET done = 1;
OPEN cur;
FETCH cur INTO var;
CLOSE cur;

最佳實踐建議

• 命名規範：使用 fn_ 前綴區分用戶函數與內置函數
• 確定性聲明：確定性函數添加 DETERMINISTIC 關鍵字，利於查詢緩存優化
• SQL 安全特性：SQL SECURITY DEFINER（默認，以創建者權限執行）vs INVOKER（以調用者權限執行）
• 避免副作用：函數中盡量不修改表數據，複雜寫操作改用存儲過程
• 測試驗證：創建後立即用 SELECT fn_name(params) 驗證邏輯正確性