如何在PHP中结合MongoDB的$geoNear与$sample随机选取附近用户

要实现“筛选指定距离内的附近用户，再随机抽取10条”的需求，不能直接在find()查询中混用$sample，因为$sample是聚合管道阶段，必须通过聚合操作完成整个流程。以下是两种可行的正确写法：

方法一：使用$geoNear聚合阶段（推荐） #

$geoNear是MongoDB专门用于地理空间近邻查询的聚合阶段，功能更全面，默认按距离由近到远排序结果，还能返回距离字段：

$pipeline = [
    [
        '$geoNear' => [
            'near' => [
                'type' => 'Point',
                'coordinates' => [12.099700, 45.267670]
            ],
            'maxDistance' => 40000,
            'distanceField' => 'distance', // 可选，返回用户到中心点的距离（单位：米）
            'spherical' => true, // 针对球面坐标系（如WGS84）必须设为true
            'query' => [] // 可选，添加额外筛选条件，比如用户状态、性别等
        ]
    ],
    [
        '$sample' => [
            'size' => 10 // 随机抽取10条文档
        ]
    ]
];

// 执行聚合查询
$result = $collection->aggregate($pipeline);

方法二：使用$match+$sample聚合阶段 #

如果更习惯原有的$near查询写法，可以用$match阶段先筛选附近用户，再通过$sample随机抽取：

$pipeline = [
    [
        '$match' => [
            'coordinate' => [
                '$near' => [
                    '$geometry' => [
                        'type' => 'Point',
                        'coordinates' => [12.099700, 45.267670]
                    ],
                    '$maxDistance' => 40000
                ]
            ]
        ]
    ],
    [
        '$sample' => [
            'size' => 10
        ]
    ]
];

$result = $collection->aggregate($pipeline);

常见错误说明 #

你之前误用$sample的核心原因：$sample不属于查询条件（find()的参数），它是聚合管道的一个处理阶段，必须放在聚合数组中，配合其他阶段（如地理空间筛选）顺序执行。

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