Yii2文件上传与数据库更新必须分两步：先用UploadedFile::getInstance()获取并保存文件，再将路径赋值给模型字段后调用save(false)；updateAll()无法处理文件逻辑，批量更新需逐条加载模型；旧文件清理须在afterSave()中对比old_avatar与avatar并unlink。
表单提交时文件上传与数据库字段更新必须分两步走
Yii2里不能指望 ActiveForm 提交一次就自动把文件存到磁盘、又把路径写进数据库——文件保存和模型保存是两个独立动作，强行绑在一起容易丢数据或路径为空。核心逻辑是：先让 UploadedFile::getInstance() 拿到文件对象，手动保存到指定路径并拿到完整 URL 或相对路径，再把这个值赋给模型属性，最后调用 $model->save()。
常见错误现象：$model->file 是空的、数据库里存的是临时路径、或报 Trying to get property 'tempName' of non-object。原因基本都是没在 rules() 里声明 'file' => 'file' 校验规则，或者漏了 'skipOnEmpty' => true，导致空文件直接触发校验失败中断流程。
- 模型中必须定义
public $file;属性，并在rules()中加['file', 'file', 'skipOnEmpty' => true, 'extensions' => 'jpg,png,gif'] - 控制器中不要用
$model->load()直接绑定文件字段，而是显式调用$model->file = UploadedFile::getInstance($model, 'file'); - 保存前判断
if ($model->file)，再执行$model->file->saveAs('uploads/' . md5(uniqid()) . '.' . $model->file->extension)，然后把生成的路径赋给$model->avatar（或其他业务字段） - 最后才调用
$model->save(false)跳过验证（因为文件已处理完，避免二次校验）
updateAll() 无法更新文件字段，必须走 ActiveRecord 流程
想用 updateAll() 一次性改一堆记录的附件路径？不行。因为 updateAll() 是原生 SQL 批量操作，不触发模型事件、不走验证、也不调用文件保存逻辑——它只会把字符串塞进字段，不会帮你移动文件、不会生成缩略图、更不会清理旧文件。
如果你硬要批量更新，唯一安全的方式是查出主键 ID 列表，逐条加载模型、赋新路径、调用 save(false)。虽然慢，但能确保 beforeSave、afterSave 和自定义文件处理逻辑正常执行。
- 正确姿势：
$ids = [1, 2, 3]; foreach ($ids as $id) { $m = Model::findOne($id); $m->avatar = '/new/path.jpg'; $m->save(false); } - 错误姿势：
Model::updateAll(['avatar' => '/new/path.jpg'], ['id' => $ids]);—— 这样旧文件还在磁盘上，也没触发任何清理钩子 - 如果真有性能压力，建议把文件路径更新拆成队列任务，用 console 命令异步执行，而不是在 Web 请求里硬扛
数据库字段更新后，旧文件没删干净怎么办
用户换头像、改封面图，数据库字段更新了，但服务器上旧文件还躺在那里，越积越多。这不是 Yii2 的 bug，是你没写清理逻辑。
关键点在于：只有在 afterSave() 里，你才能拿到“旧值”和“新值”的对比结果；而 beforeSave() 只能看到新值，旧文件路径已经不可追溯。
- 在模型里加一个临时属性，比如
public $old_avatar;，在init()或afterFind()中赋值：$this->old_avatar = $this->avatar; - 在
afterSave()中判断：if ($this->old_avatar && $this->old_avatar !== $this->avatar) { @unlink(Yii::getAlias('@webroot') . $this->old_avatar); } - 注意路径拼接必须用
@webroot，别用@web（那是 URL 前缀，不是文件系统路径） - 删除前加
@抑制警告，避免因文件不存在导致整个保存失败
多图字段更新要小心数组结构错位
当表单支持多文件上传（multiple => true），且对应数据库字段是 JSON 字符串（如 extra_images），容易出现新旧数组合并混乱、重复插入、或删错图片的问题。
典型场景：用户编辑商品，原有 3 张图，这次删了第 2 张、新增 1 张，最终应为 3 张。但若直接覆盖字段，会丢失“哪张被删”的上下文。
- 前端传过来的通常是
$_FILES['Product']['name']['extra_images']数组，后端要用UploadedFile::getInstancesByName('extra_images')获取全部实例 - 不要直接
json_encode($_POST['extra_images'])存库——那只是原始输入名，不是真实路径 - 建议做法：先查出当前数据库里的图片数组，再比对新上传的文件列表，只保存新增的、跳过未变的、额外记录待删的 ID 或路径
- 清理旧图时，用
array_diff()找出被删项，再逐个unlink()，别图省事全删再重建
uploads/ 目录就变成考古现场。 
