安全批量更新需分批（每批≤500）、加事务兜底、用WHERE id BETWEEN替代IN防超长SQL，禁用save()改用updateAll()或createCommand()->update()绕过AR生命周期，支持--start-id/--end-id参数控制范围，并克制日志输出防IO阻塞。
Yii2控制台命令里怎么安全地批量更新数据
直接用 updateAll() 一发全改，线上出事概率很高。必须加条件约束、分批执行、带事务兜底。
常见错误是：在 yii\console\Controller 子类里写个 actionUpdateData()，里面直接 User::updateAll(['status' => 1], ['id' => $ids]) —— ID 列表一过万，MySQL 就可能报 Packet too large，而且没日志、没进度、失败就丢一半。
- 用
batchInsert()或createCommand()->update()替代大数组传参，避免 SQL 超长 - 必须用
Transaction包裹每一批次，单批失败不影响其他批次 - 加
WHERE id BETWEEN ? AND ?比IN更稳定，配合主键索引走 range scan - 每批最多 500 条（视字段宽度和内存调整），用
limit(500)->offset($offset)分页查 ID 再更新
为什么不能在 console 控制器里直接 new Model() 改 save()
批量场景下，$model->save() 触发完整验证、事件（beforeSave、afterSave）、关系加载，性能断崖式下跌，还容易因某一条数据校验失败导致整批中断。
比如你只想把 10 万条订单的 is_synced 字段设为 1，但其中一条订单关联的用户被软删了，触发 ActiveRecord::validate() 失败，整个脚本就停了——而这个字段根本不需要业务校验。
- 只读取 ID 列表，用原生 SQL 或
Command::update()直接操作字段 - 绕过 AR 生命周期，不调
save()、不触发事件、不查关联表 - 如果必须走模型逻辑（比如要调用某个业务方法），则拆成「查 ID → 分批 → new Model → setAttribute → save(false)」，
save(false)跳过验证
如何让 Yii2 控制台脚本支持 --start-id 和 --end-id 参数
硬编码范围或全表扫太危险，线上必须支持按主键区间执行，方便重试和灰度。
Yii2 命令参数解析靠 $this->options 和 options() 方法，不是靠 $argv 手动解析。
public function options($id)
{
return array_merge(parent::options($id), ['start-id', 'end-id']);
}
<p>public function actionUpdateStatus($startId = null, $endId = null)
{
$query = Order::find()->where(['>=', 'id', $startId ?: 1]);
if ($endId) {
$query->andWhere(['</p>
- 参数名带连字符（
--start-id）时，方法参数名必须用下划线（$start_id）或驼峰（$startId），Yii2 会自动转换 - 不传参数时默认值设为
null，再在逻辑里判断是否启用区间限制 - 别忘了在命令描述里写清楚：
php yii order/update-status --start-id=10000 --end-id=15000
日志和进度怎么落地才不拖慢脚本
用 Yii::info() 打满日志？IO 阻塞会让脚本慢 3–5 倍。批量更新本身是 CPU+IO 密集型任务，日志策略必须克制。
关键不是“记多少”，而是“记什么”和“什么时候记”。比如每 1000 条输出一次完成数，比每条都 echo 合理得多。
- 用
file_put_contents('php://stderr', "done: {$count}\n", FILE_APPEND)直接写 stderr，不走 Yii 日志通道 - 用
memory_get_usage(true)监控内存，超 64MB 就强制gc_collect_cycles() - 更新完成后补一条统计日志：
Yii::info("Updated {$total} rows in " . (microtime(true) - $start) . "s") - 禁止在循环里做数据库日志记录（如插入
log_batch表），那是给自己埋坑
最常被忽略的是事务隔离级别和连接复用：批量更新期间，确保没其他进程在写同一张表；长时间运行的控制台命令，记得在循环末尾 Yii::$app->db->close(); 避免连接泄漏。
