如何将含INSERT IF NOT EXISTS的SQL转换为Laravel ORM查询

嘿，我来帮你搞定这个Laravel ORM转换的问题！先明确你的原生SQL核心逻辑：原子性地插入一条记录，仅当指定组合条件的记录不存在时才执行插入，这种方式比firstOrCreate更安全（毕竟firstOrCreate是先查询再插入，高并发场景下可能出现竞态条件导致重复插入）。

下面是完全匹配你原生SQL逻辑的Laravel ORM实现：

public function update_tb_tokenidparc($token, $id_vendedor_pr, $id_corretora_pr, $id_parceiro)
{
    DB::table('tb_tokenidparc')
        ->insertUsing(
            // 指定要插入的字段列表，对应原生SQL的目标字段
            ['nu_cdVendedor4E_tk1', 'nu_cdCorretoraS4E_tk', 'nu_IdParceiro_tk', 'cd_Codtokenidparc', 'status_token'],
            // 构造要插入的数据源子查询
            DB::table(DB::raw('(SELECT ? as nu_cdVendedor4E_tk1, ? as nu_cdCorretoraS4E_tk, ? as nu_IdParceiro_tk, ? as cd_Codtokenidparc, ? as status_token) as tmp'))
                ->whereNotExists(function ($query) use ($id_vendedor_pr, $id_corretora_pr, $id_parceiro, $token) {
                    // 对应原生SQL的NOT EXISTS检查逻辑
                    $query->select(DB::raw(1))
                        ->from('tb_tokenidparc')
                        ->where('nu_cdVendedor4E_tk', $id_vendedor_pr)
                        ->where('nu_cdCorretoraS4E_tk', $id_corretora_pr)
                        ->where('nu_IdParceiro_tk', $id_parceiro)
                        ->where('cd_Codtokenidparc', $token);
                })
                // 绑定参数避免SQL注入，替换原生SQL的变量拼接
                ->setBindings([$id_vendedor_pr, $id_corretora_pr, $id_parceiro, $token, '1'])
        );
}

关键细节拆解： #

• insertUsing方法：专门用于处理INSERT ... SELECT类型的原子查询，第一个参数指定目标字段，第二个参数是插入的数据源子查询，完全对应原生SQL的结构。
• whereNotExists闭包：完美复刻原生SQL的NOT EXISTS逻辑，内部的子查询就是你需要的存在性检查条件。
• 参数绑定优化：用setBindings统一传递变量，避免了原生SQL直接拼接变量带来的SQL注入风险，更符合Laravel的安全规范。

为什么你的firstOrCreate没达到预期？ #

firstOrCreate是分两步执行的：先做SELECT查询，不存在再执行INSERT。这是两个独立的SQL语句，在高并发场景下可能出现两个请求同时通过SELECT检查，然后都执行INSERT，导致重复数据。而原生SQL的INSERT ... SELECT是数据库层面的原子操作，能严格保证唯一性。

如果你的场景不存在高并发问题，也可以考虑用updateOrInsert（但注意它是“不存在则插入，存在则更新”，和你需求里的“仅插入不更新”逻辑略有差异），但要严格匹配原生SQL的逻辑，上面的insertUsing方案是最准确的选择。

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