本文详解在 laravel 迁移中通过 `db::statement()` 安全创建 mysql 存储函数（如地理距离计算函数）的完整方法，纠正误用 `db::raw()` 导致函数未生效的常见问题，并提供可直接运行的迁移代码与关键注意事项。
在 Laravel 应用中，当需要复用复杂 SQL 逻辑（例如基于经纬度计算球面距离的 calculate_distance 函数）时，将其实现为 MySQL 自定义函数是一种高效且可维护的方案。但许多开发者在迁移中误用 DB::raw()，导致函数看似“迁移成功”，实则未被数据库执行——这是因为 DB::raw() 仅生成原始 SQL 表达式对象，不会触发实际查询执行，它专为 select()、where() 等查询构建场景设计。
要真正执行 DDL（如 CREATE FUNCTION）或 DCL 语句，必须使用 DB::statement()。该方法会直接向数据库发送并执行原生 SQL，支持多语句（需确保 PDO 配置允许，见后文说明）。
以下是修正后的迁移类完整实现：
✅ 关键改进说明：
- 使用 DB::statement() 替代 DB::raw()，确保 SQL 被真实执行；
- 将 CREATE FUNCTION 拆分为独立调用，避免单次 DB::statement() 中混用多语句（部分 MySQL 驱动/配置下不支持分号分隔的多语句）；
- 采用 PHP Heredoc 语法（
- 函数声明显式指定 READS SQL DATA 和 DETERMINISTIC，符合 MySQL 严格模式要求，避免因 log_bin_trust_function_creators 限制导致创建失败。
⚠️ 重要注意事项：
- MySQL 权限：执行函数创建需具备 CREATE ROUTINE 权限，请确认 Laravel 数据库用户已授权；
- 二进制日志兼容性：若 MySQL 启用了二进制日志（binlog），需设置 log_bin_trust_function_creators = 1，或为用户授予 SUPER 权限（生产环境建议前者）；
- 迁移回滚可靠性：down() 方法中务必包含 DROP FUNCTION IF EXISTS，防止重复回滚报错；
- Laravel 版本适配：上述代码兼容 Laravel 8+（含 8.65），若使用 Laravel 9+，请确保 up() 和 down() 方法签名返回 void（如示例所示）。
验证函数是否成功创建：进入 phpMyAdmin → 选择对应数据库 → 切换至“ routines” 标签页，即可看到 calculate_distance 函数；或在 SQL 查询框中执行 SELECT calculate_distance(40.7128, -74.0060, 34.0522, -118.2437); 测试返回值。
掌握此模式后，你可将任意 MySQL 存储过程、函数或视图通过迁移统一纳入版本控制，实现数据库逻辑与应用代码的协同演进。
