Laravel MongoDB报错：Trying to access array offset on float类型值的解决

• 这个错误的核心原因是你遍历的$item不是预期的数组/文档对象，而是float类型的单个值。
• 大概率是你用于去重的查询（比如聚合或distinct）逻辑有误，返回的结果不是包含id和目标字段的完整文档结构，而是直接返回了字段的数值/字符串，导致遍历到的$item变成了单个字段值，而非可通过数组下标访问的结构。

1. 修正查询逻辑，确保返回含ID的去重结果 #

如果你要同时获取动态字段$product_field的唯一值和对应文档ID，必须用MongoDB聚合框架构建分组查询，示例代码：

$productField = 'brand'; // 动态传入的字段名
$perPage = 10;
$page = request()->get('page', 1);
$skip = ($page - 1) * $perPage;

// 聚合查询：按目标字段分组去重，同时保留对应文档ID
$results = Product::raw(function ($collection) use ($productField, $skip, $perPage) {
    return $collection->aggregate([
        [
            '$group' => [
                '_id' => '$' . $productField, // 按目标字段分组实现去重
                'docId' => ['$first' => '$_id'], // 取分组内首个文档的ID
                'fieldValue' => ['$first' => '$' . $productField] // 保留字段值
            ]
        ],
        ['$skip' => $skip], // 分页跳过条数
        ['$limit' => $perPage] // 分页限制条数
    ]);
});

2. 正确遍历获取ID #

聚合返回的每个$item是包含docId（原文档ID）、fieldValue（去重后的字段值）的结构，遍历的时候要对应正确的键名：

foreach ($results as $item) {
    // 将MongoDB的ObjectId转为字符串
    $id = (string) $item['docId'];
    $uniqueFieldValue = $item['fieldValue'];
    // 后续业务逻辑
}

3. 常见错误排查点 #

• 如果你之前用了Product::distinct($productField)->get()，这个方法只会返回该字段的唯一值数组，没有ID，遍历自然会拿到单个值而非数组/对象，直接触发报错。
• 打印dd($results)查看返回结构，如果输出是纯数值/字符串数组，说明查询逻辑完全偏离预期，需重新调整聚合规则。
• 检查模型主键设置：如果你的Laravel模型将MongoDB默认的_id映射为id（设置了protected $primaryKey = 'id'），要确保聚合查询中返回的是id而非_id。

4. 优雅实现分页 #

如果不想手动处理skip和limit，可以把聚合结果转成Laravel标准分页对象：

$items = collect($results);
// 先查询去重后的总数量
$total = Product::raw(function ($collection) use ($productField) {
    $countResult = $collection->aggregate([
        ['$group' => ['_id' => '$' . $productField]],
        ['$count' => 'total']
    ]);
    return $countResult[0]['total'] ?? 0;
});

// 构建分页对象
$paginatedItems = new \Illuminate\Pagination\LengthAwarePaginator(
    $items,
    $total,
    $perPage,
    $page,
    ['path' => request()->url(), 'query' => request()->query()]
);

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