save() 是 Yii ActiveRecord 新增数据最常用入口，但非直接写库，而是走校验→判断新旧记录→调用 insert() 的完整流程；值错误、规则未过、类型不匹配均会导致静默失败。
save() 是 Yii ActiveRecord 新增数据最常用的入口，但它不是“直接写库”，而是走校验 + 判断新旧记录 + 调用 insert() 的完整流程。值赋得不对、规则没过、类型不匹配，都会静默失败。
用 attributes 块赋值前先确认字段是安全属性
ActiveRecord 默认只允许对 rules() 里声明为“安全”的字段做批量赋值。比如：
public function rules()
{
return [
[['name', 'email'], 'required'],
['age', 'integer'], // age 是安全字段
['status', 'in', 'range' => [0, 1]], // status 也是
['avatar_url', 'string', 'max' => 255], // 也是
];
}
如果表里有个 created_at 字段没在 rules() 里声明，$model->attributes = $data 就不会给它赋值——哪怕 $data 里有这个键。
- 不加
safe规则的字段，只能单个赋值：$model->created_at = time(); - Gii 生成的模型常把
TINYINT字段默认设成'string'规则，你传1（int）会校验失败，必须传'1'或改规则为'integer' - 用
$model->load($post)时同理：只加载安全字段，且依赖表单字段名格式如User[username]
save() 失败时别只看返回值，要查 getErrors()
$model->save() 成功返回 true，失败返回 false，但不会抛异常——错误信息藏在 getErrors() 里：
if (!$model->save()) {
$errors = $model->getErrors();
// $errors 是二维数组，如 ['name' => ['Name cannot be blank.']]
var_dump($errors);
}
- 常见错误包括：必填字段为空、整型字段传了字符串、邮箱格式不对、唯一索引冲突
- 如果
getErrors()返回空数组，但save()还是失败，检查是否触发了beforeSave()返回false，或数据库层面限制（如 NOT NULL 但没设默认值） - 调试时可临时关闭验证：
$model->save(false)，但上线前必须恢复
主键自增 ID 在保存后才能拿到，别在 save() 前读 id
新增时 $model->id 初始是 null 或 0，save() 成功后才被自动填充：
$model = new User();
$model->name = 'awen';
$model->age = 30;
if ($model->save()) {
echo $model->id; // ✅ 此时才有值，比如 123
// ❌ 不要在这里用 $model->attributes['id']，它可能还是 null
}
- 循环批量插入时，每次都要重置新记录状态：
$model->setIsNewRecord(true)，否则第二次save()会走更新逻辑 - 如果模型主键不是自增（比如 UUID），需在
save()前手动赋值$model->id = \Yii::guid(); - 不要依赖
Yii::$app->db->getLastInsertID()获取当前模型 ID——它只反映上一条 INSERT 语句，多线程/事务下不可靠
最易忽略的一点：ActiveRecord 的 save() 行为完全取决于 isNewRecord 状态，而这个状态只在 new Model() 或显式调用 setIsNewRecord(true) 时为真；从 find() 拿到的对象，哪怕你清空所有字段，save() 仍会执行 UPDATE。新增逻辑必须确保对象是“新”的，而不是“看起来像新的”。
