Laravel中whereBetween方法传入request参数查询不生效问题

问题根因 #

90%以上的概率是请求传入的start_roll、end_roll参数类型为字符串，或存在不可见的特殊字符/空格，和数据表中roll_number的数值类型不匹配，导致范围查询逻辑异常。硬编码数值查询正常，正是因为硬编码的参数是数值类型，和字段类型匹配。

解决方案 #

步骤1：参数校验+强制类型转换 #

查询前先对请求参数做验证和类型转换，避免非法值、类型不匹配问题：

// 先做参数合法性校验
$validated = $request->validate([
    'teacher_id' => 'required|integer',
    'start_roll' => 'required|integer|min:1',
    'end_roll' => 'required|integer|gte:start_roll',
]);

// 强制转成整数后再传入查询条件
$studentData = Student::where('teacher_id', $validated['teacher_id'])
    ->whereBetween('roll_number', [
        (int)$validated['start_roll'],
        (int)$validated['end_roll']
    ])
    ->get();

步骤2：配置模型字段类型转换 #

确认Student模型中已经为数值字段配置了正确的类型转换，避免查询时字段被当作字符串处理：

// 在Student.php模型中添加$casts属性
protected $casts = [
    'teacher_id' => 'integer',
    'roll_number' => 'integer',
];

步骤3：排查真实执行的SQL参数 #

如果上述操作后仍异常，可以打印真实执行的原生SQL和绑定参数，确认参数实际传入值：

// 开启查询日志
\DB::enableQueryLog();
// 执行你的查询语句
$studentData = Student::where('teacher_id',$request->teacher_id)->whereBetween('roll_number',[$request->start_roll,$request->end_roll])->get();
// 打印完整查询信息，包含绑定的真实参数
dd(\DB::getQueryLog());

输出结果中的bindings字段就是实际传入查询的参数值，可直接确认是否符合预期。

内容的提问来源于stack exchange，提问作者A.A Noman