导入SQL文件前须确认字符集兼容性、主键与时间戳字段命名、大文件分拆及序列化数据处理,否则中文乱码、emoji报错、find()失效等问题频发。

导入前必须确认数据库字符集和表结构兼容性
phpMyAdmin 导入 SQL 文件失败,八成卡在字符集或字段定义上。Laravel 9 默认用 utf8mb4_unicode_ci,但老旧数据导出时可能用 latin1_swedish_ci 或没声明 CHARSET。如果直接导入,中文变问号、emoji 插入报错、TEXT 字段超长被截断都是常见现象。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
- 打开导出的
.sql文件,搜索CREATE TABLE,检查每张表末尾是否有ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;没有就手动补上 - 若文件里有
SET NAMES latin1或类似语句,删掉或改成SET NAMES utf8mb4 - 用 phpMyAdmin 导入时,在「格式」下方勾选「SQL 兼容模式」,并把「字符集」下拉框明确选为
utf8mb4 - 如果表中含
JSON字段,确认 MySQL 版本 ≥ 5.7(Laravel 9 要求),否则导入会跳过该字段或报错Invalid default value for 'xxx'
导入后 Laravel 9 读不到数据?重点查主键和时间戳约定
Laravel 9 的 Eloquent 默认找 id(小写)作为主键、created_at/updated_at 作为时间戳字段。但老旧系统常使用 ID、add_time、modify_time 等命名,不改模型配置,Model::find(1) 就静默返回 null。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 在对应模型中显式声明:
protected $primaryKey = 'ID';、protected $keyType = 'int'; - 禁用自动时间戳:
public $timestamps = false;;若需保留,再加:const CREATED_AT = 'add_time'; const UPDATED_AT = 'modify_time'; - 避免用
find()方法——它硬编码查id字段;改用where('ID', 123)->first() - 检查
app/Providers/AppServiceProvider.php中是否误启用了全局软删除(Model::shouldBeStrict()或中间件干扰),会导致无deleted_at字段的旧表查询全空
大 SQL 文件导入失败:别硬扛,分拆或换命令行
phpMyAdmin 对上传大小有硬限制(默认常为 2MB),而老旧业务数据库动辄上百 MB。强行调高 upload_max_filesize 和 post_max_size 很容易触发超时或内存溢出,且 phpMyAdmin 本身不显示实时进度,失败后难定位哪一行出问题。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 用文本编辑器(如 VS Code)打开大
.sql文件,按CREATE TABLE或INSERT INTO手动切分成多个 ≤ 2MB 的小文件,逐个导入 - 更稳的方式是切到服务器终端,用
mysql命令行导入:mysql -u root -p your_database_name ,完全绕过 PHP 限制 - 若只有 FTP 权限无法进终端,可上传
bigdump.php工具(轻量级分片导入脚本),配合 phpMyAdmin 的「导入」页面使用,它会自动分批执行 - 导入前先在目标库运行:
SET FOREIGN_KEY_CHECKS = 0;,导入完成再SET FOREIGN_KEY_CHECKS = 1;,避免外键约束导致中途中断
JSON 字段或序列化数据不能直接导入?得先解包再插
老旧系统常把数组存成 PHP serialize() 字符串(如 a:2:{i:0;s:5:"apple";i:1;s:6:"banana";})或原始 JSON 字符串({"status":"active","tags":["vip"]})。phpMyAdmin 导入时只当普通字符串写入,Laravel 9 模型取出来仍是字符串,不是数组——$user->meta['tags'] 会报错。
实操建议:
立即学习“PHP免费学习笔记(深入)”;
- 导入前用脚本预处理
.sql文件:把所有serialize(替换为JSON_OBJECT((不推荐),或更稳妥地,用 PHP 脚本读取旧数据、反序列化、再生成新 INSERT 语句 - 导入后,在 Laravel 中用访问器(accessor)自动解包:
public function getMetaAttribute($value) { return is_string($value) ? @json_decode($value, true) ?: @unserialize($value) : $value; } - 若字段值含中文且乱码,说明导出时未用 UTF-8 编码保存
.sql文件——用编辑器另存为 UTF-8(无 BOM),再重试 - 别依赖 phpMyAdmin 的「JSON 格式导出」选项:它只对 MySQL 5.7+ 原生 JSON 类型有效,老旧系统基本不用该类型,导出仍是字符串
find() 查不到、save() 自动覆盖时间戳、where() 隐式加 ORDER BY id 导致结果错乱——这些都不会报错,只会让你花几小时怀疑数据没导入成功。


















