最稳的SQL导入方式是直接调用mysql命令行工具；PHP的mysqli_multi_query()因无法处理注释、DELIMITER、存储过程等易出错，仅适用于极小干净片段；大文件须异步导入并预处理编码、DEFINER及权限语句。
直接调用 mysql 命令行工具是最稳、最不踩坑的方式；PHP 本身没有“安全可靠导入 .sql 文件”的内置函数，所有基于 fopen() + mysqli_query() 或 mysqli_multi_query() 的纯 PHP 实现，在真实项目中都容易在注释、字符串分号、存储过程、字符集或权限上翻车。
为什么 mysqli_multi_query() 在 PHP 8.x 里依然不推荐用于 SQL 文件导入
mysqli_multi_query() 看似能一次执行多条语句，但它对输入内容极其敏感：遇到 -- 注释、/* */、DELIMITER $$、CREATE PROCEDURE 或开头的 USE db_name; 就会报 Commands out of sync 或静默失败。它也不会跳过空行或自动处理字符集声明。
实操建议：
- 仅限极小、干净、人工生成的 SQL 片段（比如几条
INSERT），且确认不含任何注释和跨语句结构 - 执行后必须配合
mysqli_next_result()和mysqli_store_result()轮询，否则后续查询会卡住 - 无法定位哪一行出错——报错时只告诉你“第 1 条语句之后”，但你不知道第 1 条是
CREATE TABLE还是INSERT
用 exec() 调用 mysql 命令的最小可行写法
绕过 PHP 的 SQL 解析层，把活交给 MySQL 自己干，这是生产环境和本地开发最通用的做法。关键不是“能不能用”，而是“怎么用得安全、可查、不崩”。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- SQL 文件路径必须是绝对路径，且 PHP 进程（如
www-data或nginx用户）有读取权限 - 数据库必须提前存在，且用户有
CREATE、INSERT、DROP权限 - 命令中密码不要明写：
mysql -u root -p'pass' db_name < /var/www/data.sql→ 改用--defaults-file=/path/to/my.cnf或mysql_config_editor - 加
-f参数可跳过单条错误继续执行，但会掩盖建表失败导致后续插入报No database selected这类连锁问题 - 捕获输出：
$output = []; $return_code = 0; exec("mysql -u root --defaults-file=/tmp/mysql.cnf mydb < " . escapeshellarg($sql_path), $output, $return_code);，检查$return_code !== 0再看$output
大文件上传 + 后台导入的典型链路（PHP 8.2+ 推荐）
Web 界面上传 50MB+ SQL 文件？别碰 upload_max_filesize 和 max_execution_time 这些危险开关。真实项目里，上传只是第一步，导入必须异步。
实操建议：
- 前端用
Blob.slice()分片上传，后端接收后拼成临时文件（路径带时间戳，如/tmp/import_20260511123456.sql） - 不立即执行导入，而是写入队列（如 Redis List 或简单文本队列），由
crontab每分钟扫一次触发php /path/to/import_worker.php -
import_worker.php只做一件事：调用exec("mysql -u ...")，记录日志，成功后删临时文件，失败则发告警 - 避免在 Web 请求中调用
set_time_limit(0)—— 它治标不治本，且可能被 Nginx 的fastcgi_read_timeout截断
预处理 SQL 文件的三个必做动作（尤其从生产导出）
很多导入失败根本不是 PHP 或命令的问题，而是 SQL 文件本身含本地不兼容内容。别跳过这步。
实操建议：
- 用 VS Code 打开，右下角确认编码是 UTF-8 without BOM；若显示 “UTF-8 with BOM”，立刻另存为无 BOM 版本，否则中文全乱码
- 正则替换掉所有
DEFINER=`[^`]+`@`[^`]+`（含反引号），替换成空；MySQL 8.0+ 默认用caching_sha2_password，本地 root 一般没配这个插件 - 删掉
SET time_zone =、DATA DIRECTORY、TABLESPACE、CREATE USER、GRANT这类语句——本地开发不需要也不该执行它们
真正麻烦的从来不是“怎么导入”，而是“怎么让导入不中断、出错能定位、失败不污染数据库”。命令行方式看着原始，但它把控制权交还给 MySQL，反而最可控。那些花哨的 PHP 封装，往往省了三行代码，却埋下三天调试的坑。
