Laravel Telescope 中严格模式下的 Eloquent 查询问题解析

问题背景

在 Laravel 开发中，我们经常会使用 Eloquent ORM 进行数据库操作。当启用严格模式(Model::shouldBeStrict(true))时，Eloquent 会对模型属性进行更严格的检查，确保所有访问的属性都已被正确加载。这种严格模式有助于发现潜在的数据访问问题，但有时也会带来一些意料之外的行为。

具体问题表现

开发者在进行聚合查询时遇到了一个典型问题：当使用 selectRaw 进行自定义聚合计算时，系统抛出了"MissingAttributeException"异常，提示模型缺少 id 属性。然而，当改用多次 sum 查询进行计算时，却能正常工作。

问题根源分析

1. 严格模式的机制：启用严格模式后，Eloquent 会检查所有被访问的属性是否确实存在于模型中或已被加载。这包括模型的主键(id)字段。

2. 聚合查询的特殊性：当使用 selectRaw 进行聚合计算时，查询结果实际上只包含计算字段(total_point)，而不包含模型的其他字段(包括id)。但在严格模式下，Eloquent 仍然期望能访问到这些基础字段。

3. Telescope 的介入：错误发生在 Telescope 尝试记录请求信息时，它需要获取模型的键(id)来进行格式化，而此时模型实例缺少这个关键字段。

解决方案

对于这种聚合查询场景，正确的做法是使用 toBase() 方法将查询转换为基础查询构建器，避免 Eloquent 的模型转换：

$currentPoint = CustomerPoint::where('customer_id', $customer->id)
    ->whereDate('expired_at', '>=', Carbon::now())
    ->orderBy('ordering')
    ->selectRaw('sum(`in`) - sum(`out`) as total_point')
    ->toBase()  // 关键修改
    ->first();

技术要点解析

1. toBase() 方法的作用：将 Eloquent 查询转换为基础的查询构建器，跳过模型实例化过程，特别适合只返回标量值的聚合查询。

2. 严格模式的适用场景：严格模式更适合常规的模型操作，能帮助发现 N+1 查询等问题。但对于聚合查询等特殊场景，需要适当调整查询方式。

3. 性能考量：使用 toBase() 的聚合查询比多次 sum 查询更高效，只需一次数据库访问即可完成计算。

最佳实践建议

1. 对于只返回计算结果的查询，优先考虑使用 toBase() 方法。

2. 在严格模式下开发时，注意区分常规模型操作和特殊查询场景。

3. 聚合查询尽量在数据库层面完成，减少数据传输和PHP计算开销。

4. 在复杂查询场景下，可以考虑使用 DB 门面直接构建查询，完全避开 Eloquent 的模型转换。

通过理解 Eloquent 的严格模式机制和查询构建器的工作原理，开发者可以更灵活地处理各种数据库操作场景，在保证代码质量的同时实现最佳性能。