本文详解如何在 Laravel 中安全、可靠地执行来自外部 .sql 文件的大型原生 SQL 查询（如多层嵌套、JSON 构造、UNION 子句等），重点解决因字符串解析、引号转义、语法注入导致的 missing quotation mark 等常见错误，并提供生产就绪的最佳实践。
本文详解如何在 laravel 中安全、可靠地执行来自外部 .sql 文件的大型原生 sql 查询（如多层嵌套、json 构造、union 子句等），重点解决因字符串解析、引号转义、语法注入导致的 `missing quotation mark` 等常见错误，并提供生产就绪的最佳实践。
在 Laravel 应用中直接执行 .sql 文件中的原生 SQL（尤其是 Moodle 数据库导出的复杂查询）是一个高频但易出错的需求。你遇到的 missing quotation mark at position 1025 错误，并非 SQL 本身语法错误（已在 phpMyAdmin 和 EverSQL 验证通过），而是 Laravel 的 DB::select() 方法无法直接解析含多行、多引号、注释或特殊转义结构的原始 SQL 字符串——它期望的是已预编译的参数化语句，而非“文件即 SQL”的字面量执行。
❌ 错误用法解析
// ❌ 错误：DB::select() 不接受完整 SQL 字符串（尤其含换行、嵌套引号）
$fileData = Storage::disk('local')->get('/public/query.sql');
$jsonFileData = DB::select($fileData); // → 触发解析异常：引号/括号不匹配DB::select() 是为安全执行带绑定参数的 SELECT 语句设计的，底层调用 PDO 的 prepare() + execute()。而你的 .sql 文件内容包含：
- 多层嵌套的单引号（如
'value1':'1'）、反斜杠转义（\'）； - 大量换行与缩进（Laravel 解析器易在行首/行尾误判语句边界）；
-
JSON_OBJECT()、GROUP_CONCAT()、CASE WHEN等 MySQL 专有函数； - UNION ALL 子查询与复杂子查询别名。
这些特性使原始字符串无法被 Laravel 的查询构建器或 PDO 预处理机制正确识别，从而报出位置相关的语法错误。
✅ 正确方案：使用 DB::unprepared() 执行纯 SQL 脚本
Laravel 提供了 DB::unprepared() 方法，专用于执行不返回结果集的原生 SQL 脚本（如 CREATE, INSERT, UPDATE）。但注意：你的查询是 SELECT，需返回结果，因此不能直接用 unprepared()。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
✅ 推荐方案：通过 PDO 原生连接执行并获取结果
use Illuminate\Support\Facades\DB;
public function store()
{
$sql = Storage::disk('local')->get('/public/query.sql');
// 关键：使用 PDO 原生执行，绕过 Laravel 查询构建器解析
$pdo = DB::getPdo();
$stmt = $pdo->prepare($sql);
$stmt->execute();
$results = $stmt->fetchAll(\PDO::FETCH_ASSOC);
// 返回 JSON 格式响应（适用于 API）
return response()->json(['data' => $results]);
}⚠️ 注意事项：
- 确保
.sql文件无 BOM 头（Windows 记事本易添加），否则prepare()会失败；- 若 SQL 含
DELIMITER或存储过程定义，需先用DB::unprepared()分段执行；- 生产环境务必校验文件来源（如仅读取
storage/app/public/queries/下白名单文件），防止路径遍历攻击（如../../.env）；- 对于超大结果集（如
LIMIT 300仍可能返回 MB 级 JSON），建议添加set_time_limit(120)和内存限制提示。
? 安全增强：SQL 文件内容预处理（可选）
若 SQL 中存在动态占位符（如 :tenant_id），可用 str_replace 安全注入（切勿拼接用户输入！）：
$sql = str_replace(':limit', (int) request('limit', 300), $sql);
$sql = str_replace(':category_exclude', implode(',', [33, 99]), $sql);? 总结：何时用什么方法？
| 场景 | 推荐方法 | 说明 |
|---|---|---|
| ✅ 纯 SELECT 查询（含复杂 JSON/UNION） | $pdo->prepare($sql)->execute() |
最可靠，完全绕过 Laravel 解析层 |
| ✅ DDL/DML 脚本（CREATE/INSERT） | DB::unprepared($sql) |
内置安全，自动处理分号分割 |
| ⚠️ 简单 SELECT（无嵌套、无引号冲突） | DB::select($sql) |
仅限极简语句，不推荐用于 .sql 文件 |
| ❌ 尝试转 Eloquent / SQLtoEloquent | 放弃 | 此类深度嵌套查询无法被任何转换工具准确还原，徒增维护成本 |
最终，不要试图将复杂原生 SQL “适配”进 ORM。Laravel 的设计哲学是“用对的工具做对的事”——当 SQL 已是最佳表达时，就该信任数据库引擎，用最直接的方式执行它。
