Laravel+MySQL插入语句本地正常但线上数据库不执行如何解决？

可能原因及对应解决方案 #

1. 异常静默未捕获（最高概率） #

线上环境默认关闭APP_DEBUG，插入时触发的异常不会直接输出，代码走到Result::create()时直接抛出异常终止执行，根本不会进入后续的if判断，你可以先捕获异常查看具体报错信息：

// 先引入Log门面
use Illuminate\Support\Facades\Log;

// 替换原有create逻辑
try {
    $result = Result::create($data);
    if ($result) {
        $inserted++;
        Log::info('inserted matchId: '. $match['matchId']);
    }
} catch (\Exception $e) {
    // 错误信息会写入storage/logs/laravel.log文件
    Log::error('插入失败: ' . $e->getMessage(), [
        'trace' => $e->getTraceAsString(),
        'data' => $data
    ]);
}

也可以直接查看线上的Laravel运行日志，定位具体错误原因。

2. 线上代码/缓存未更新 #

• 确认线上部署的Result模型文件确实已经修改为protected $guarded = []，避免部署时漏同步代码
• 执行Laravel全量缓存清理命令，避免旧配置/代码缓存生效：

php artisan config:clear
php artisan cache:clear
php artisan route:clear
php artisan view:clear

• 如果服务器开启了OPcache，重启php-fpm服务清空字节码缓存。

3. 数据库字段约束/配置差异 #

虽然你确认表结构一致，但仍需排查以下差异：

• 线上MySQL是否开启严格模式：本地默认可能关闭严格模式，不校验字段类型/长度，线上开启后如果出现int字段传字符串、字段值超出长度等问题会直接报错插入失败
• 字段属性校验：比如properties字段如果是varchar类型，json_encode后的内容超出长度会插入失败；platform_id等字段如果设置了NOT NULL但传入null也会触发错误
• 确认数据库用户权限确实包含对应表的INSERT权限，避免授权未生效。

4. 模型事件/观察者拦截 #

检查项目中是否注册了Result模型的观察者，或者模型内部定义了creating/saving事件回调，如果回调中返回false会直接终止插入操作，很多时候本地测试时未启用观察者，线上配置开启后会触发拦截。

5. 外层事务未提交 #

如果insertUniqueMatches方法是在事务逻辑中调用，后续事务执行失败触发回滚，会导致插入的记录被撤销，你可以单独调用该方法测试排除事务影响。

快速定位技巧 #

你可以临时将Result::create($data)替换为DB门面插入，快速判断是模型层问题还是数据库层问题：

if (\DB::table('results')->insert($data)) {
    $inserted++;
}

如果DB插入正常，问题集中在模型层的赋值、事件拦截等逻辑；如果DB也插入失败，问题集中在数据库约束、权限等配置。

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