Laravel迁移报错SQLSTATE[42000]：存储过程/函数语法错误求助

这种跨版本环境下的迁移报错，大概率是MariaDB版本差异导致的语法兼容问题——毕竟MariaDB 5.5.59是比较老旧的版本（发布于2018年），和10.1.23在存储过程/函数的语法支持、配置限制上有不少区别。结合你提到的场景，我整理了几个最可能的原因和对应的解决思路：

1. 存储过程/函数的语法不符合MariaDB 5.5的严格规范 #

MariaDB 10.x系列对语法的容错性更高，一些简化写法在10.1里能正常运行，但在5.5里会直接触发语法错误。常见的坑点包括：

• DELIMITER的缺失或使用错误：5.5要求在创建存储过程/函数前必须显式修改分隔符，否则会把;当成整个语句的结束符，导致存储过程的逻辑被截断。
• 变量声明位置错误：5.5要求所有局部变量必须在BEGIN后的第一部分声明，不能穿插在业务逻辑中间。
• 关键字冲突：10.x新增的一些关键字（比如JSON相关的）在5.5里可能被当成普通标识符，但如果你的存储过程里用到了这些词，必须用反引号``包裹。
• 函数特性未显式声明：5.5默认要求创建函数时必须指定DETERMINISTIC、NO SQL或READS SQL DATA等特性（如果开启了二进制日志的话），否则会报错。

解决办法：
把迁移文件里的存储过程/函数代码改成符合5.5规范的写法，举个例子：

// 错误写法（在5.5里会报错）
DB::statement('
    CREATE PROCEDURE get_user()
    BEGIN
        SELECT * FROM users;
    END;
');

// 正确写法
DB::unprepared('
    DELIMITER //
    CREATE PROCEDURE get_user()
    BEGIN
        SELECT * FROM users;
    END //
    DELIMITER ;
');

如果是创建函数，要加上特性声明：

CREATE FUNCTION get_user_count() RETURNS INT DETERMINISTIC
BEGIN
    RETURN (SELECT COUNT(*) FROM users);
END;

2. Laravel迁移的SQL执行方式问题 #

PHP 7版本的PDO驱动和Laravel的SQL处理逻辑，在配合旧版MariaDB时，可能会对多语句SQL（比如包含DELIMITER的存储过程）解析出错。而DB::statement()会对SQL进行预处理，可能破坏DELIMITER的逻辑。

解决办法：
改用DB::unprepared()来执行存储过程/函数的创建语句——这个方法不会对SQL做预处理，能完整保留原始的语句结构，更适合执行包含DELIMITER或多语句的SQL。

3. MariaDB 5.5的配置限制 #

如果你的MariaDB 5.5开启了二进制日志（默认可能开启），那么log_bin_trust_function_creators参数默认是0，这会阻止创建没有显式声明特性的函数，即使是root用户也会触发错误。

解决办法：

• 临时解决：登录MariaDB执行SET GLOBAL log_bin_trust_function_creators = 1;，立即生效但重启后会失效。
• 永久解决：修改MariaDB的配置文件（比如/etc/my.cnf或my.ini），添加或修改log_bin_trust_function_creators = 1，然后重启MariaDB服务。

4. 字符集与排序规则不兼容 #

两台服务器的数据库字符集、排序规则不一致，也可能导致SQL解析时出现语法错误。比如10.1默认用utf8mb4，而5.5对utf8mb4的支持有限，可能会把某些字符当成语法错误。

解决办法：

• 检查两台服务器的数据库默认字符集，把5.5的数据库字符集改成和10.1一致的（如果10.1用的是utf8mb4，5.5可能需要改成utf8，因为5.5不支持完整的utf8mb4）。
• 在迁移文件里创建表或存储过程时，显式指定字符集，比如CREATE TABLE users (...) DEFAULT CHARSET=utf8;。

先从语法规范和DB::unprepared()的使用入手排查，这两个是最常见的原因。如果还是不行，再检查配置参数和字符集。

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