应使用 try...catch 包裹单行处理逻辑，捕获异常时记录 $rowIndex 和原始行内容；校验 PhpSpreadsheet 单元格是否为 null；CSV 读取前设置 auto_detect_line_endings；主动查重而非依赖 INSERT IGNORE；检测并转码非 UTF-8 中文；导出失败行到可编辑 Excel 并提供下载。
PHP 导入 Excel 班级通信录时部分成功、部分失败，怎么定位失败行？
关键不是“重试”，而是让 fgetcsv 或 PhpSpreadsheet 显式暴露哪一行出错、为什么错。默认静默跳过或中断后不反馈行号，是导入半途失败却找不到原因的主因。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
try...catch包裹单行数据处理逻辑，捕获异常后记录$rowIndex（从 1 开始计）和原始行内容 - 不要在循环中直接
continue或break，先array_push($failedRows, ['row' => $i, 'data' => $row, 'error' => $e->getMessage()]) - Excel 导入时，用
PhpSpreadsheet的getCellByColumnAndRow()需校验是否为null，空单元格可能返回NULL而非空字符串，导致strlen(null)触发 warning 并被当成 false 处理 - 若用
fgetcsv()读 CSV，务必设置ini_set('auto_detect_line_endings', true)，否则 Windows 换行符\r\n在 Linux 下可能截断最后一列
手机号/学号重复导致插入失败，但没报错行号
MySQL 的 INSERT IGNORE 或 ON DUPLICATE KEY UPDATE 会吞掉冲突，不抛异常，自然无法被捕获。这不是“导入成功”，而是“跳过写入”——但业务上你可能需要知道谁被跳过了。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 改用
INSERT ... SELECT+LEFT JOIN检查是否存在，或先SELECT COUNT(*)查重，再决定 INSERT；失败时主动记录该行 - 给班级表加唯一索引时，明确用
ALTER TABLE students ADD UNIQUE KEY uk_student_id (student_id)，而不是依赖主键——主键可能为自增 ID，学号才是业务唯一标识 - 如果必须用
INSERT IGNORE，可在执行后调用$pdo->rowCount()：返回 0 表示全被忽略，此时结合原始数据逐行比对student_id是否已存在
中文姓名/班级名乱码，导致 MySQL 插入失败并跳过整行
常见现象是某行日志显示 SQLSTATE[HY000]: General error: 1366 Incorrect string value，本质是 CSV 或 Excel 中文本编码不是 UTF-8，而数据库连接、表字符集虽为 utf8mb4，但 PHP 读取时已损坏。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
mb_detect_encoding($str, ['UTF-8', 'GBK', 'BIG5'], true)检测每行姓名字段编码，非 UTF-8 则转码：mb_convert_encoding($name, 'UTF-8', $detected) - CSV 文件务必用记事本另存为「UTF-8 无 BOM」格式；Excel 导出 CSV 时默认带 BOM，可用
file_get_contents()读取后用ltrim($content, "\xEF\xBB\xBF")去除 - 连接 PDO 时显式指定字符集：
new PDO($dsn, $user, $pass, [PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"])
导出失败行到 Excel 或 CSV 供人工复核
别只写日志文件。老师需要打开就能看哪几行没进去、缺什么字段、是不是多打了空格——得是人能直接编辑的格式。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
PhpSpreadsheet新建工作簿，把$failedRows写入新 sheet，列头包含row、student_name、phone、error - 对
error列内容做截断处理（如mb_strimwidth($msg, 0, 50, '...')），避免 Excel 单元格撑爆 - 生成后提供下载链接，响应头设为：
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');和header('Content-Disposition: attachment;filename="failed_import_rows.xlsx"');
