ThinkPHP模型save()时需手动校验字段组合唯一性，因unique规则不支持多字段联合唯一，应通过where()+count()查重并排除自身；导入Excel时应批量查重而非逐行查询，并注意NULL值导致联合索引失效问题。
ThinkPHP 模型 save() 时怎么校验字段组合唯一性
直接用 unique 验证规则只能校验单字段，组合唯一（比如 user_id + sku_id）必须手动干预。ThinkPHP 的验证器不原生支持多字段联合唯一，硬套 ['unique' => 'table,field1,field2'] 会报错或失效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在模型的
beforeWrite或save()前，用where()+count()主动查重：$exists = $this->where(['user_id' => $data['user_id'], 'sku_id' => $data['sku_id']])->count();
注意：要排除自身（更新场景），加->where('id', '', $this->id) - 别依赖数据库唯一索引做唯一性兜底——它只抛
Integrity constraint violation异常，前端无法区分是哪个字段冲突、也无法友好提示 - 如果并发写入高，仅应用层查重有竞态风险；真正防重必须配合数据库联合唯一索引（如
ALTER TABLE order_items ADD UNIQUE KEY uk_user_sku (user_id, sku_id);），但代码里仍要先查再写，否则异常难捕获
ThinkPHP 导入 Excel 时怎么跳过已存在的记录
用 ThinkPHP + PHPExcel/PhpSpreadsheet 导入时，常见需求不是“报错中断”，而是“跳过重复项，只导入新数据”。关键在「查」和「跳」的时机与粒度。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要每行都执行一次
where()->find()—— IO 太重，1000 行可能触发上千次查询。应先批量取出所有待导入的组合键（如['user_id,sku_id']），再用where IN一次性查出库中已存在的全部组合：$keys = array_column($rows, 'user_id', 'sku_id');<br>$existKeys = Db::name('order_items')->where('concat(user_id,"_",sku_id)', 'in', $keys)->column('concat(user_id,"_",sku_id)'); - 用
array_diff_key()或循环比对，筛出干净的新数据再批量插入，避免insertAll()中混入重复项导致部分失败 - 注意字符编码和空格：Excel 里导出的数字可能被当字符串读，
123和"123"在 MySQL 中可能不等价；建议统一 cast 类型或用trim()预处理
为什么用了 unique 索引还出现重复插入
MySQL 的联合唯一索引生效前提是字段值不为 NULL —— 如果其中一列允许 NULL，那么 (1, NULL) 和 (1, NULL) 被视为不同记录，索引不拦截。
常见错误现象：
- 导入时某字段为空，数据库存成
NULL，导致联合唯一失效 - 建表时没设
NOT NULL，又没给默认值，实际业务中该字段理应必填
解决办法：
- 建联合唯一索引前，确认所有参与字段均为
NOT NULL，例如：ALTER TABLE order_items MODIFY user_id INT NOT NULL DEFAULT 0;<br>ALTER TABLE order_items MODIFY sku_id VARCHAR(32) NOT NULL DEFAULT '';
- 导入前强制清洗数据：空字符串、空白符、"null" 字符串全转成默认值或抛出提示，别让 NULL 流到数据库
- 用
INSERT IGNORE或ON DUPLICATE KEY UPDATE替代普通INSERT，但要注意这会让失败静默，不适合需要明确反馈的业务场景
PHPExcel 导入后怎么把错误行号和原因返回给前端
用户上传 Excel 后，不能只回一句“导入失败”，得指出第几行哪一列出了什么问题。难点在于：验证逻辑分散（格式、长度、唯一性）、错误需按行聚合、还要保留原始行号（Excel 行号 ≠ 数组 key）。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 遍历每一行时，用真实 Excel 行号（比如
$rowIndex + 1）作为错误数组的 key：$errors[$rowIndex + 1] = [];<br>if (empty($cellValue)) {<br> $errors[$rowIndex + 1][] = 'SKU 不能为空';<br>} - 唯一性校验这类跨行检查，放在所有行解析完之后再集中做，否则无法知道“当前行是否和前面某行重复”；但错误信息里仍要标注双方行号（如“第5行与第12行 user_id+sku_id 重复”）
- 别把整个
$errors直接json_encode返回——前端渲染大表格很慢。建议限制最多返回前 20 条错误，并加total_error_count字段供前端提示“共发现 142 条错误，仅显示前 20 条”
