ThinkPHP批量更新需手动映射字段，因默认按数组键名拼SQL且不触发模型钩子；TP6中须设$autoWriteTimestamp=false并调用useMap(true)启用$map映射，或预处理数据重命名字段。
ThinkPHP 的批量更新（update 或 saveAll）默认按数组键名映射字段，一旦键名与数据库字段不一致（比如传了 user_name 但表里是 username），就会静默跳过或报错——这不是 Bug，是设计逻辑，必须手动做字段映射。
批量更新时字段名不匹配导致数据没更新
常见现象：调用 $model->saveAll($dataList) 后返回 true，但数据库里对应字段值仍是旧的；或者抛出 SQLSTATE[HY000]: General error: 1364 Field doesn't have a default value 错误。根本原因是 ThinkPHP 按数组键名（如 'user_name'）直接拼 SQL，不走模型的 type、attribute 或 set 钩子。
- 只对单条记录生效的
setAttr/getAttr在批量场景下完全不触发 -
saveAll()内部用的是Db::table()->insert()或update()原生写法，绕过模型属性转换 - 即使定义了
protected $map = ['user_name' => 'username']，TP6 默认也不启用该配置（需显式开启）
TP6 中启用 $map 字段映射并用于批量更新
TP6 支持通过 protected $map 声明字段别名映射，但必须配合 protected $autoWriteTimestamp = false 和显式启用映射开关，否则无效。
- 在模型类中声明：
protected $map = ['user_name' => 'username', 'create_time' => 'ctime'] - 必须设置：
protected $autoWriteTimestamp = false（否则时间字段会干扰映射逻辑） - 关键一步：调用前启用映射 ——
$model->useMap(true)，否则$map被忽略 - 然后才能安全使用：
$model->useMap(true)->saveAll($dataList)
更可控的方式：手动预处理数据数组
绕过模型映射机制，自己做字段重命名，适用于复杂映射、动态字段或 TP5.x 环境（无 useMap 方法）。
立即学习“PHP免费学习笔记（深入）”；
- 写个简单转换函数：
function remapFields(array $data, array $map): array { return array_map(function ($item) use ($map) { $mapped = []; foreach ($item as $key => $val) { $mapped[$map[$key] ?? $key] = $val; } return $mapped; }, $data); } - 使用示例：
$mappedData = remapFields($rawData, ['user_name' => 'username', 'status_text' => 'status']) - 再执行：
Db::name('user')->update($mappedData)（注意：这是原生批量 update，要求主键存在且唯一） - 优势：不依赖模型，兼容 TP5/TP6，可嵌入中间件或 service 层统一处理
用 Db::table()->update() 时字段映射失效的真相
直接调用 Db::table('user')->update($list) 时，ThinkPHP 不经过任何模型层，$map、setAttr、type 全部失效。它只认数组键名是否为合法字段名。
- 错误写法：
Db::table('user')->update([['id'=>1, 'user_name'=>'foo']])→user_name字段不存在，被丢弃 - 正确做法：要么提前重命名键名，要么改用
Db::execute()手写 SQL（适合极简字段替换） - 注意：TP6.1+ 的
update()支持关联更新，但字段映射仍不自动介入，必须靠外层处理
字段映射不是“开了就自动生效”的功能，它需要显式激活、配合约束条件，并且在不同调用路径（模型 saveAll / Db update / 原生 query）下行为完全不同。最容易被忽略的是 useMap(true) 这个调用时机——漏掉它，前面所有 $map 都白配。
