ThinkPHP数据更新失败主因是WHERE条件未匹配、主键缺失、事务未提交或字段被自动过滤；应先用find()验证记录存在，确认主键命名与模型配置一致，检查字段是否在允许列表中，并开启strict模式或Db::getLastSql()定位问题。
ThinkPHP 数据更新失败，多数不是 SQL 写错了，而是条件没命中、主键缺失、事务未提交或字段被自动过滤导致的“静默跳过”。先确认是否真执行了更新操作，再逐层排查。
检查 WHERE 条件是否匹配到数据
更新语句执行后返回 0 行影响，最常见原因是 WHERE 条件查不到记录。ThinkPHP 的 update() 或 save() 不会报错，只会安静返回 false 或 0。
- 用
Db::table('user')->where('id', 100)->find()先验证该记录是否存在 - 避免用字符串拼接 ID：
where('id', $id)比where("id = $id")更安全，防止空值或类型不一致（如字符串 '100' vs 整数 100） - 注意软删除模型：如果表启用了
soft_delete，且记录已被标记删除，则update()默认不生效，需加withTrashed()或改用forceUpdate()
确认主键与更新方式是否匹配
ThinkPHP 对主键有强依赖。用 save() 更新时，必须保证数据中包含合法主键值，否则会转为插入操作。
- 模型实例更新：
$user = User::find(1); $user->name = 'Tom'; $user->save();—— 正确，主键已加载 - 数组方式更新：
User::update(['id'=>1, 'name'=>'Tom']);—— 必须显式带id，且字段名要和数据库一致（不能是user_id） - 若主键名不是
id（如uid），需在模型中声明：protected $pk = 'uid';
排查字段写入限制与自动过滤
ThinkPHP 默认会忽略非数据表字段，也会拦截非法字段名，导致部分字段“更新了但没存进去”。
立即学习“PHP免费学习笔记（深入）”；
- 检查模型中是否设置了
protected $field = ['name', 'email'];，若未包含目标字段，会被直接丢弃 - 确认字段名大小写：MySQL 在 Linux 下区分大小写，
userName和username是两个字段 - 避免使用保留字作字段名（如
order,group,key），否则需用反引号或改名 - 开启严格模式可暴露问题：
Db::table('user')->strict(true)->update($data);，遇到非法字段会抛异常
验证事务与连接状态
批量更新或嵌套逻辑中，事务未提交、连接中断或死锁都会造成更新“看似成功实则回滚”。
- 手动开启事务后，务必调用
commit()；任一环节出错需rollback() - 用
Db::getLastSql()打印实际执行的 SQL，确认是否被框架重写（例如自动添加时间戳字段） - 检查 MySQL 错误日志：
SHOW ENGINE INNODB STATUS\G查看是否有 lock wait timeout - 若用长连接或连接池，留意
wait_timeout设置，空闲连接可能被服务端主动断开
