Laravel搭建类Udemy网校：如何自动将冻结余额14天后转为可用余额

核心思路 #

用Laravel自带的任务调度（基于Cron Job）完全可行，这是这类定时批量任务的标准解决方案，全程无需人工干预。

具体实现步骤 #

1. 数据库表设计调整 #

建议单独创建wallet_frozen_funds表来存储每笔冻结资金的明细，避免和主钱包表耦合，核心字段如下：

• id：主键
• instructor_id：关联讲师ID
• amount：冻结金额
• expired_at：解冻时间（datetime类型）
• status：状态（可选值：frozen/unfrozen）
• created_at/updated_at：时间戳

每笔冻结资金单独记录，方便后续精准筛选到期待解冻的记录。

2. 生成自定义Artisan命令 #

创建处理解冻逻辑的命令：

php artisan make:command UnfreezeExpiredFunds

在生成的app/Console/Commands/UnfreezeExpiredFunds.php中编写业务逻辑：

<?php

namespace App\Console\Commands;

use App\Models\WalletFrozenFund;
use App\Models\InstructorWallet;
use Illuminate\Console\Command;

class UnfreezeExpiredFunds extends Command
{
    protected $signature = 'funds:unfreeze';
    protected $description = '自动解冻到期的讲师冻结资金';

    public function handle()
    {
        // 筛选所有已到期且未解冻的资金记录
        $expiredRecords = WalletFrozenFund::where('status', 'frozen')
            ->where('expired_at', '<=', now())
            ->get();

        foreach ($expiredRecords as $record) {
            // 开启事务，防止余额数据不一致
            \DB::transaction(function () use ($record) {
                // 更新讲师钱包余额：冻结余额减少，可用余额增加
                $wallet = InstructorWallet::where('instructor_id', $record->instructor_id)->first();
                $wallet->decrement('frozen_balance', $record->amount);
                $wallet->increment('available_balance', $record->amount);

                // 标记该笔冻结记录为已解冻
                $record->update(['status' => 'unfrozen']);
            });
        }

        $this->info('本次共解冻 ' . $expiredRecords->count() . ' 笔资金');
    }
}

3. 配置Laravel任务调度 #

打开app/Console/Kernel.php，在schedule方法中添加定时规则：

protected function schedule(Schedule $schedule)
{
    // 每天凌晨1点执行解冻任务（可根据需求调整频率，比如每小时执行一次）
    $schedule->command('funds:unfreeze')->dailyAt('01:00');
}

4. 配置服务器Cron Job #

在服务器上添加一个Cron任务，让Laravel调度器每分钟运行一次（Laravel会自动判断哪些任务到了执行时间）：

* * * * * cd /你的项目根目录路径 && php artisan schedule:run >> /dev/null 2>&1

额外优化建议 #

• 强制事务：所有余额变更操作必须包裹在事务中，避免中途报错导致数据错乱
• 日志记录：可以在命令中添加日志记录，比如记录每笔解冻的讲师ID、金额、时间，方便后续排查问题
• 频率灵活调整：如果对解冻时效性要求高，可将任务频率改为每小时/每10分钟一次，不会产生性能压力
• 幂等性保障：通过status字段标记已解冻状态，确保同一笔资金不会被重复处理

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