Excel导入班级通信录需精准识别空值：先trim()和标准化全角空格，再用=== ''严格判断；区分必填与可选字段，按业务规则处理；读取时用calculateWorksheetDimension()获取真实数据范围，避免空行；数据库字段应设DEFAULT NULL，并确保PHP层不插入未赋值字段。
Excel 导入班级通信录时，NULL、空字符串 ''、全空格或空白单元格常被误判为有效数据，导致数据库写入异常或校验失败。跳过空值不是简单地用 empty() 判断就能解决的——它会把 '0'、0、false 也过滤掉，而姓名字段为 '0' 虽罕见，学号或电话却可能合法含数字零。
判断空值前先 trim() 和标准化单元格内容
Excel 解析（如用 PhpSpreadsheet）后，单元格值可能是带不可见字符的字符串，比如 "\t \n" 或 " "（全角空格）。直接 empty($cell) 返回 true，但你其实想保留真实非空内容。
- 对每个待导入字段（如
$name、$phone），先做trim($cell->getValue()) - 再替换常见全角空格：
str_replace([' ', "\u{3000}"], ' ', $trimmed) - 最后用
=== ''严格比对是否为空字符串，避免empty()的隐式转换陷阱
区分“允许为空”和“必须跳过”的字段
班级通信录中，student_id 通常不能为空，而 emergency_contact 可为空。跳过空值 ≠ 统一忽略所有空字段——得按业务规则处理：
- 关键字段（如
name、class_no）：若为空，应中断当前行导入，并记录错误行号，不跳过 - 可选字段（如
email、address）：若为空字符串或null，直接跳过赋值（即不执行$user->email = $value） - 数值型字段（如
score）：需额外判断是否为is_numeric($val)，否则' '过了trim仍是空，但'-1'是合法值
用 PhpSpreadsheet 读取时主动跳过整行空行
用户常手动在 Excel 末尾多留几十行空格，导致 getHighestRow() 返回远大于实际数据行数。逐行检查 isEmpty() 效率低，且容易漏判（比如某行只有边框无内容）。
立即学习“PHP免费学习笔记（深入）”；
- 读取前先获取数据范围：
$worksheet->calculateWorksheetDimension()，它比getHighestRow()更准 - 遍历范围时，对每一行调用
$worksheet->rangeToArray("A{$row}:Z{$row}", null, true, false)，再检查该数组是否全为null或空字符串 - 发现连续 3 行全空，可
break提前退出循环，避免无效解析
数据库插入前用 NULLABLE 字段配合默认值
PHP 层跳过空值只是第一步。如果数据库字段定义为 NOT NULL 且无默认值，哪怕 PHP 没传值，MySQL 也会报错 Field 'xxx' doesn't have a default value。
- 建表时，可为空字段明确设为
DEFAULT NULL，例如：email VARCHAR(255) DEFAULT NULL - 使用 PDO 或 Laravel Eloquent 时，确保未设置的字段不参与
INSERT语句（Eloquent 默认只插入已赋值属性） - 避免用
COALESCE($email, '')强制转空字符串——这会让空值变''写入，后续查询WHERE email IS NULL就查不到
真正难的不是写几行 if (!empty($v))，而是厘清哪些空是“业务上不该存在”，哪些是“用户确实没填”。一个班级通信录里，name 为空大概率是录入错误，而 wechat_id 为空大概率是正常情况——这个判断逻辑必须落在字段语义上，而不是统一用 empty() 扫一遍。
