Laravel Eloquent模型作用域中whereNotIn()使用异常问题

核心问题分析 #

你遇到的现象（小天数过滤无效、大天数全量过滤）大概率是两个原因导致的：

1. 日期比较逻辑错误：toDateString()的转换丢失了时间精度，加上可能的时区不匹配，导致小天数范围内没有匹配到Transaction表的记录，最终$blacklist为空数组。而whereNotIn('phonenumber', [])是无效SQL，Laravel会直接忽略这个条件，所以过滤无效果；当天数足够大时，$blacklist包含了Lead表所有的手机号，自然会过滤掉全部数据。
2. 数据类型不匹配：如果flow_id在数据库中是整数类型，你用字符串'752'做比较会触发数据库隐式转换，可能导致过滤逻辑异常。

修复步骤 #

1. 修正日期比较逻辑

去掉toDateString()，直接使用Carbon实例进行时间比较（Laravel会自动处理为数据库兼容的datetime格式），保留完整的时间精度：

public function scopeNotBlacklisted(Builder $query): void
{
    // 直接用now()->subDays(N)，无需转日期字符串
    $blacklist = Transaction::where('finalized_at', '>=', now()->subDays(100))
        ->where('flow_id', '!=', 752) // 去掉引号，用整数匹配数据库类型
        ->pluck('phonenumber');
        
    $query->whereNotIn('phonenumber', $blacklist);
}

2. 优化为子查询（更可靠高效）

避免将大量手机号加载到内存，同时解决空数组导致的过滤失效问题（子查询无结果时，whereNotIn会正常返回所有记录）：

public function scopeNotBlacklisted(Builder $query): void
{
    $subquery = Transaction::select('phonenumber')
        ->where('finalized_at', '>=', now()->subDays(100))
        ->where('flow_id', '!=', 752);

    $query->whereNotIn('phonenumber', $subquery);
}

3. 额外验证点

• 检查Laravel配置（config/app.php）的timezone与数据库时区是否一致，避免时间基准偏差。
• 确认Transaction和Lead表中的手机号字段名拼写完全一致（比如是phonenumber还是phone_number）。
• 手动执行SQL验证小天数范围是否有数据：

  SELECT phonenumber FROM transactions WHERE finalized_at >= DATE_SUB(NOW(), INTERVAL 1 DAY) AND flow_id != 752;
  

  如果该SQL无结果，说明数据库中确实没有符合条件的记录，过滤无效是正常现象。

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