fgetcsv在Web请求中卡住PHP进程是因为PHP同步阻塞模型下，Web SAPI的worker被长时间占用无法响应其他请求。
为什么 fgetcsv 在 Web 请求里直接跑会卡住整个 PHP 进程
PHP 默认是同步阻塞模型，fgetcsv 读大文件、foreach 处理上千条数据、再逐条 INSERT INTO，整个 HTTP 请求就卡在那儿——超时、Nginx 504、用户刷新重试，全来了。这不是代码写得不好，是模型本身不扛这种活。
关键点在于：Web SAPI（如 Apache 或 FPM）的 worker 进程一旦被占住，就不能响应其他请求。哪怕你加了 set_time_limit(0)，也只是延长超时，没解决并发阻塞问题。
- 单次导入超过 500 行，就该考虑异步
- 文件上传后立刻返回「已收到，正在处理」，比卡 30 秒强得多
- 别用
exec('php import.php &')这种裸后台命令——没进程管理、无错误捕获、权限混乱
用 pcntl_fork 做轻量级子进程要避开哪些坑
如果你用的是 PHP-FPM（绝大多数线上环境），pcntl_fork 是禁用的——它会破坏 FPM 的进程模型，导致 worker 挂死或内存泄漏。只有 CLI SAPI 下才安全可用，所以它只适合本地脚本或定时任务场景，不适合 Web 端直连触发。
真要用 fork，必须满足三个条件：
立即学习“PHP免费学习笔记（深入）”；
- 运行在 CLI 模式（
php /path/to/import.php） - 主进程立即
exit，不等待子进程，避免阻塞响应 - 子进程自己处理错误日志、数据库连接重建（不能复用父进程的 PDO 实例）
示例片段（仅作逻辑示意，勿直接用于 FPM）：
// CLI only
$pid = pcntl_fork();
if ($pid == -1) {
throw new Exception('fork failed');
} elseif ($pid == 0) {
// child: close DB conn, re-init, do import
$pdo = new PDO(...); // 新建连接
importFromCsv($filePath);
exit(0);
} else {
// parent: return success immediately
echo json_encode(['status' => 'queued']);
}
推荐方案：用队列 + Worker 进程解耦导入任务
最稳的做法是把「上传 → 入队 → 后台消费」三步拆开。Web 请求只负责解析文件头、校验格式、存原始文件、发消息到队列，剩下的交给独立的 Worker 进程处理。
技术选型建议：
- 队列用
Redis的LPUSH/BRPOP就够用，不用上 RabbitMQ/Kafka - Worker 用
php artisan queue:work（Laravel）或自写while(true){ $job = redis->brpop(...); ... } - 导入任务中关闭自动提交，用
$pdo->beginTransaction()+ 批量INSERT ... VALUES (...),(...)提升 5–10 倍速度 - 每处理 100 行做一次
UPDATE task_log SET progress = ? WHERE id = ?，前端可轮询查进度
注意：不要在 Worker 里用 $_SESSION 或 $_COOKIE——它们不存在；所有上下文（如用户 ID、班级 ID）必须随任务一起序列化进队列。
前端怎么配合才能让用户不觉得“没反应”
用户点击「导入」后，如果只弹个「请稍候」然后没下文，大概率会重复点击。需要前后端协同提供确定性反馈：
- 上传成功后立即返回
{ task_id: "import_abc123", status: "pending" } - 前端启动
fetch('/api/import/status?task_id=...')轮询，间隔 1.5s，最多 10 次 - 后端
/api/import/status只查 Redis 或数据库里的task_log记录，不碰 CSV 文件 - 状态值用明确语义：
pending/processing/success/failed，失败时带error_message字段
真正容易被忽略的是：CSV 编码和换行符。Windows 上传的 \r\n、Mac 的 \r、UTF-8 BOM 头，都会让 fgetcsv 读错行。务必在入队前用 mb_convert_encoding($content, 'UTF-8', 'auto') 统一转码，并用 str_replace(["\r\n", "\r"], "\n", $content) 归一化换行。
