Laravel执行cronjob批量插入数据失败未捕获异常问题咨询

无异常无写入的核心原因排查 #

• 日志级别配置验证：Laravel 中 debug 级别的日志仅当 APP_LOG_LEVEL 配置为 debug 时才会持久化存储，如果后续调整过日志级别为 info 及以上，你代码中的 \Log::debug 输出会被直接丢弃，看起来就像没有任何异常和日志产出。可以临时将日志方法替换为 \Log::error 复现测试，确认是否有异常信息输出。
• PHP 进程终止场景排查：CLI 模式下的 max_execution_time 配置、cron 任务本身的超时限制、服务器 OOM kill 进程等场景，都会直接终止脚本运行，不会触发 PHP 异常捕获逻辑，也不会写入日志。可以在代码开头增加 set_time_limit(0) 取消 CLI 模式的执行时间限制，同时观察服务器监控确认是否存在内存溢出的情况。
• 数据库锁/阻塞问题排查：如果 pharmacies 表存在其他常驻读写操作持有表锁/行锁，你的全表 delete 或者批量 insert 操作会被直接阻塞，若数据库锁等待超时参数设置过长，或者 cron 任务提前被终止，就会出现无报错无写入的情况。可以在定时任务执行时在数据库执行 show processlist 命令，确认是否有处于阻塞状态的 SQL。
• 数据源有效性验证：如果后续的 $data 本身为空数组，代码会正常执行全表删除、事务提交，也会打印保存成功的日志，但实际没有新数据插入，看起来就像写入失败。可以在删除操作前增加日志打印 count($data)，确认数据源是否正常生成。

针对性优化解决方案 #

• 优化日志记录逻辑，覆盖全流程关键节点，同时将异常日志调整为不会被轻易过滤的 error 级别：

DB::beginTransaction();
try {
    \Log::info("药房数据同步任务启动，待插入数据量：".count($data));
    $deleteCount = DB::table('pharmacies')->delete();
    \Log::info("旧数据清理完成，删除条数：".$deleteCount);
    $insertTotal = 0;
    foreach(array_chunk($data, 50) as $piece) {
        Pharmacy::insert($piece);
        $insertTotal += count($piece);
    }
    DB::commit();
    \Log::info("数据同步成功，总插入条数：".$insertTotal);
} catch(\Exception $e) {
    DB::rollback();
    \Log::error("数据同步失败：".$e->getMessage(), [
        'trace' => $e->getTraceAsString()
    ]);
}

• 增加 cron 任务输出重定向，避免进程被强制终止时 PHP 无法写入日志的问题，cron 配置参考如下：
  * * * * * php /你的项目路径/artisan schedule:run >> /自定义日志路径/cron_schedule.log 2>&1
• 优化全表删除逻辑：如果 pharmacies 表数据量较大，delete 全表会持有表锁很长时间，建议替换为 truncate table pharmacies 操作，执行速度更快，锁持有时间更短，大幅降低死锁概率。
• 增加数据库超时配置：在 Laravel 的数据库配置文件中增加 PDO 超时参数，避免 SQL 长时间阻塞无响应：

'options' => [
    PDO::ATTR_TIMEOUT => 30, // SQL 执行超过30秒自动超时抛出异常
],

内容的提问来源于stack exchange，提问作者Lam