Yii2中用ActiveForm更新数据库的核心是：先用Model::findOne($id)加载原记录，再$model->load()绑定POST数据，通过验证后调用save()——它基于主键执行UPDATE，自动跳过未修改字段，确保验证、事件和业务逻辑不被绕过。
Yii2 中如何用 ActiveForm 正确提交并更新数据库记录
直接改数据库记录，核心是让模型加载用户提交的数据、验证通过、再调用 save()。不是手动拼 SQL，也不是绕过模型直接操作 QueryBuilder——那样会跳过验证、事件和业务逻辑。
常见错误现象：save() 返回 false 但没看 $model->getErrors()；表单提交后数据没变，其实是没触发更新（比如主键没设对）；或者用了 load() 却传错参数导致数据根本没进模型。
- 确保控制器中用
$model->load(Yii::$app->request->post())，第二个参数默认是''（空字符串），不要写成'ModelName'除非你显式设置了表单 name 前缀 - 更新前必须先查出原记录：
$model = ModelName::findOne($id)，不能 new 一个空模型再 load —— 那样会变成插入新记录 -
save()默认只更新脏字段（dirty attributes），但前提是模型已存在且有主键值；如果主键被 unset 或为 null，它会转成 insert
表单里怎么写才能正确绑定字段并提交
ActiveForm 的字段名必须和模型属性名一致，否则 load() 不会赋值。它靠 HTML name 属性映射，不是靠 ID 或 label。
典型错误：手写 <input name="title">，但模型属性叫 name；或用了 form->field($model, 'status')->dropDownList(...) 却忘了在模型的 rules() 里允许 status 被批量赋值（即加到 safe 或显式指定场景）。
- 使用
$form->field($model, 'attribute_name')是最稳妥的，它自动处理 name、id、label 和错误显示 - 如果要自定义 HTML，name 必须是
ModelName[attribute_name]（默认情形），例如：<input name="User[name]"> - 提交按钮必须是
<button type="submit">或<input type="submit">，且在$form->begin()和$form->end()之间
为什么 save() 没报错但数据库没更新
最常踩的坑是模型没设置主键，或主键字段被设为 NOT NULL DEFAULT '' 导致查询失败却静默忽略。Yii 更新时依赖主键生成 WHERE 条件，找不到匹配行就什么也不做。
另一个隐蔽问题是事务或 beforeSave 返回 false —— 它会中断保存但不抛异常，只返回 false。
- 检查
$model->isNewRecord：更新时它应为false；如果是true，说明模型没从 DB 加载成功 - 执行
var_dump($model->getDirtyAttributes())看哪些字段被标记为“已修改”，空数组说明没变化或没触发赋值 - 打开 Yii 调试工具栏里的 DB 面板，确认是否发出了 UPDATE 语句；如果没有，问题一定出在
load()或主键环节
带文件上传的更新怎么处理
文件上传不走 load()，因为 $_POST 里没有文件内容。必须单独用 UploadedFile::getInstance() 获取，再手动赋值给模型属性（比如 $model->avatar），最后在 beforeSave 或控制器里保存物理文件并写入路径到 DB。
注意：模型规则里要用 file 验证器，且表单 <form> 必须带 enctype="multipart/form-data"，否则 UploadedFile::getInstance() 返回 null。
- 验证器示例：
['avatar', 'file', 'extensions' => 'png, jpg', 'maxSize' => 1024*1024] - 保存文件前务必先调用
$model->avatar->saveAs($path)，再把$path赋给另一个属性（如$model->avatar_path）并save() - 别在
rules()里把文件属性设为safe就完事——它只是允许批量赋值，不等于自动处理上传
真正容易被忽略的是主键一致性：数据库主键字段名、模型 primaryKey() 返回值、以及实际查询出来的记录是否真包含该主键值。三者只要差一点，save() 就会悄无声息地变成 insert 或什么都不做。
