<p>PHP 8.3 导入 UTF-8 数据乱码的根源是旧习惯被严格检查放大：BOM 未清除、substr 误用、mysqli_setcharset 时机错；须先跳过 BOM、强制用 mb* 函数并显式传编码、合理分批事务与禁用事件日志。</p>
PHP 8.3 导入 UTF-8 编码数据时出现乱码，根本原因不是 PHP 版本升级导致的“新 bug”，而是旧习惯在新环境下被放大——fgetcsv() 不自动识别 BOM、substr() 被误用于中文截取、mysqli_set_charset() 调用时机错误，这些老问题在 PHP 8.3 的严格多字节检查下会直接报 Warning 或静默错位。
用 fgetcsv() 读 CSV 中文乱码，先砍 BOM 再设 locale
Windows 下生成的 UTF-8 CSV 文件常带 BOM（\xEF\xBB\xBF），fgetcsv() 会把它当正文开头，导致第一列字段名或值前多出不可见字符，后续所有列偏移错位。
- 打开文件后立刻读头 3 字节：
$head = file_get_contents($file, false, null, 0, 3);，若等于"\xEF\xBB\xBF"，就用fopen($file, 'rb')+fseek($fp, 3)跳过 - 不依赖系统 locale 也能解，但加一句
setlocale(LC_CTYPE, 'zh_CN.UTF-8')（Linux）或setlocale(LC_CTYPE, 'Chinese_China.65001')（Windows）能减少部分mb_*函数的隐式转换异常 - 别用
stream_filter_append($fp, 'convert.iconv.UTF-8/GB18030')强转——它只适用于源文件确实是 GBK/GB18030 的情况；若源就是 UTF-8 却强转，反而制造乱码
入库前字符串处理必须用 mb_*，且编码参数不能省
PHP 8.3 对多字节函数调用更严格：mb_substr($str, 0, 10) 若没传第三个编码参数，会触发 E_DEPRECATED；而 substr() 处理中文必然截断字节，造成后续 json_encode() 失败或数据库存入乱码。
- 所有长度判断统一用
mb_strlen($s, 'UTF-8')，所有截取统一用mb_substr($s, $start, $len, 'UTF-8') - 用户输入或 CSV 字段含空格/换行时，先
trim()再mb_trim()（需自定义函数，内部用mb_ereg_replace('^[\s ]+|[\s ]+$', '', $s, 'm')） - 日期字段若从 Excel 来（如数值
44926），用PhpSpreadsheet\Shared\Date::excelToDateTimeObject($value)，别自己加 25569 —— PHP 8.3 的DateTime构造对毫秒精度更敏感，偏移错 1 秒会导致整点偏差
mysqli 批量插入中断？查 max_allowed_packet 和事务粒度
导入中途停在第 327 行或第 1024 行附近，大概率是单条 INSERT SQL 超长，触发 MySQL 的 max_allowed_packet 截断，而非 PHP 内存溢出。
立即学习“PHP免费学习笔记（深入）”；
- 连接后立刻执行：
$mysqli->query("SET max_allowed_packet = 64*1024*1024");（64MB，按需调高） - 拼
VALUES时控制每批不超过 500 组（即INSERT INTO t VALUES (..),(..),...,(..)最多 500 个括号），避免单 SQL 超过 packet 限制 - 开启事务但别撑太久：
$mysqli->begin_transaction();，每 500 行$mysqli->commit(); $mysqli->begin_transaction();，否则锁表时间过长可能被 MySQL kill
Laravel 导入大 Excel 卡死？禁事件 + 分块 + 关日志不是可选项
哪怕只是 5 万行 xlsx，用默认 Import 类也会把整张 Sheet 加载进内存，PHP 8.3 的 GC 在大量对象引用下效率下降明显，内存峰值轻松破 1GB。
- 必须实现
WithChunkReading，chunkSize()返回500（不是 1000 —— PhpSpreadsheet 解析开销比 CSV 高得多） - 模型事件必须关：
Model::withoutEvents(fn() => $this->upsert(...))，否则每个created事件都会触发观察者实例化 - 开发环境外一律禁用查询日志：
DB::disableQueryLog()，导入完也不用恢复 —— 日志只在调试慢 SQL 时有用，批量导入中它本身就是性能黑洞
最易被忽略的是：BOM 检测必须在 fopen() 之后、fgetcsv() 之前完成；而 mb_* 函数的编码参数一旦漏写，在 PHP 8.3 下不会静默 fallback，而是直接警告并返回 false —— 这类错误往往藏在日志深处，只影响部分数据行，极难复现。
