Fatal error 导致导入中断需优先定位具体错误类型和位置；常见原因包括内存耗尽（代码结构或库缓存问题）、超时（I/O或SQL瓶颈）及扩展缺失（如mbstring未启用），应通过错误日志、流式读取、批量事务、禁用冗余功能等综合解决。
PHP Fatal error 导入时直接中断，说明 PHP 解析器在执行过程中遇到了不可恢复的错误
这类错误不是警告或 notice，而是让脚本立刻终止——所以导入中途卡住、数据库没写完、文件残留临时状态，都很常见。关键不是“怎么继续导入”，而是先定位 fatal error 的具体类型和触发位置。
最常踩的坑是：只看浏览器报错“Fatal error: Allowed memory size exhausted”，就去调大 memory_limit，结果下次报 Maximum execution time of 30 seconds exceeded，又去改 max_execution_time，来回折腾却没解决根本问题。
- 打开 PHP 错误日志（不是 Apache/Nginx 日志），路径通常是
/var/log/php_errors.log或由error_log配置项指定 - 确保
display_errors = Off（线上必须关），但log_errors = On，否则你永远看不到真实错误行号 - 导入脚本开头加
error_reporting(E_ALL); ini_set('display_errors', '1');仅用于本地快速验证，上线前删掉
内存耗尽（Allowed memory size exhausted）不等于数据量大，很可能是代码结构问题
比如用 file_get_contents() 一次性读取 20MB CSV，或在循环里不断 new 对象却不 unset，都会迅速撑爆默认 128M 内存。但更隐蔽的是：某些 ORM 或 Excel 库（如 PhpSpreadsheet）默认启用缓存、自动类型推断、公式计算——这些功能在导入时全开，内存占用会翻几倍。
- 处理大文件优先用流式读取：
fopen()+fgetcsv()，而不是file_get_contents()+str_getcsv() - 如果必须用
PhpSpreadsheet，初始化时显式关闭不需要的功能：$reader->setReadDataOnly(true); $reader->setReadEmptyCells(false); -
memory_limit临时调高只是掩耳盗铃；真正要压内存，得配合gc_collect_cycles()在每 100 行后手动触发垃圾回收
超时（Maximum execution time exceeded）往往暴露了 I/O 或查询瓶颈，而非单纯时间不够
导入慢，90% 不是因为 PHP 执行慢，而是卡在 MySQL 插入、文件锁等待、或远程 API 调用上。比如用 INSERT INTO ... VALUES (...), (...), (...) 批量插入 5000 行，看着快，但如果表有多个索引、触发器或外键约束，实际耗时可能远超预期。
- 禁用索引再导入：
ALTER TABLE `table` DISABLE KEYS;，导入完再ENABLE KEYS;（仅 MyISAM 有效；InnoDB 用SET FOREIGN_KEY_CHECKS=0;+SET UNIQUE_CHECKS=0;） - 避免在循环里执行单条
INSERT；改用事务包裹批量操作，但单个事务别超过 5000 行，否则回滚成本高、锁表时间长 - 检查是否在导入循环中调用了未加缓存的
file_exists()或curl_exec()—— 这些 I/O 操作比 PHP 运算慢两个数量级
扩展缺失或版本冲突导致的 Fatal error 最难排查，因为错误信息极简
例如报 Fatal error: Uncaught Error: Call to undefined function mb_detect_encoding()，表面看是函数不存在，实际是 mbstring 扩展没启用；又或者升级 PHP 8.1 后，旧版 mysql_connect() 直接报错，但提示仍是泛泛的 “Fatal error”，连函数名都不显示（因已被彻底移除）。
立即学习“PHP免费学习笔记（深入）”；
- 运行
php -m确认必需扩展已加载，特别是mbstring、xml、zip、gd（某些导入库依赖它们） - 用
php -v核对 CLI 和 Web SAPI（如 FPM）是否为同一版本；常见陷阱是命令行跑通，但浏览器访问失败，因为 Apache 加载的是另一套 php.ini - 检查
extension_dir路径是否正确，尤其在 Docker 或自编译 PHP 环境下，扩展文件可能根本没被找到
资源瓶颈从来不是孤立的内存或 CPU 数字，而是 PHP 配置、扩展行为、SQL 引擎策略、文件系统特性四者咬合出的问题。漏掉其中任一环，调参就只是把错误从一个地方赶到另一个地方。
