ThinkPHP6 不支持直接执行 SQL 文件，错误源于手动读取拼接执行；应避免 file_get_contents + query()，推荐用 mysql 命令行导入，注意字符集与数据库前缀。
ThinkPHP6 本身不提供直接执行 SQL 文件（如 .sql 脚本）的内置方法，所谓“执行 SQL 文件报错”，本质是开发者尝试用 PHP 读取文件后拼接执行，过程中容易出错。问题通常不在框架，而在操作方式、SQL 内容或执行环境。解决重点是：**不用 raw 拼接、不手动分号切割、不绕过 PDO 安全机制**。
别用 file_get_contents + query() 硬执行
这是最常见也最危险的做法。例如：
✘ 错误示范file_get_contents('install.sql') 读出含多条语句（建表+插入+注释）的字符串，再传给 Db::execute() 或 Db::query() —— PDO 默认不支持一次执行多条语句（除非开启 PDO::MYSQL_ATTR_MULTI_STATEMENTS，但 ThinkPHP6 并未开放该配置，且存在严重安全风险）。
结果往往是：只执行第一条就卡住、遇到注释崩溃、分号被当语法错误、字符集乱码导致建表失败。
立即学习“PHP免费学习笔记（深入）”；
正确导入 SQL 文件的三种方式
① 用命令行 mysql 客户端（推荐，最稳）
在服务器终端执行：mysql -u root -p your_database <br>
无需 PHP 参与，跳过所有解析和编码陷阱，适合部署、初始化、迁移场景。
② 分句解析 + 单条执行（适用于必须 PHP 控制的场景）
需手动剥离注释、按分号切分、过滤空行和 DELIMITER 语句，并逐条调用 Db::execute()：
- 用正则或专用 SQL 解析器（如
sql-parserComposer 包）安全拆分； - 跳过
--、/* */注释行； - 忽略
DELIMITER和存储过程体（TP6 不适合管理复杂过程）； - 每条语句末尾不能带分号（PDO 不认）；
- 建表语句注意引擎、字符集是否与当前 MySQL 版本兼容（如
utf8mb4_0900_ai_ci在老版本不支持）。
③ 改用迁移工具（长期项目首选）
安装 topthink/think-migration，把 SQL 文件逻辑转为迁移类：
- 每张表一个
create_xxx_table.php类； - 用
Schema::create()构建结构，避免手写 SQL； - 数据初始化走 seed 类，而非原始 INSERT；
- 执行
php think migrate:run，自动处理顺序、依赖与回滚。
常见报错对应排查点
SQLSTATE[42000]：语法错误
不是 TP6 错，是 SQL 文件里用了高版本语法（如 JSON 字段、窗口函数），或字段名含保留字没加反引号（`order`）。
SQLSTATE[HY000][2002]：连接失败
说明执行前数据库根本连不上——先按标准流程检查 MySQL 服务、账号权限、host 白名单，别急着调 SQL 文件。
乱码或中文变问号
确认 SQL 文件本身是 UTF-8 编码（无 BOM）；my.cnf 中 character-set-server=utf8mb4；TP6 配置 'charset' => 'utf8mb4'；建表语句显式声明 CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci。
报 “Unknown database” 或 “Table doesn’t exist”
检查 SQL 文件开头是否有 USE xxx;？TP6 不会自动切换库，需确保连接配置指向目标库，或在语句中写全库名前缀（your_db.your_table）。
