新手求助：求Parse-Server Query Builder完整文档指引（MongoDB环境）

作为经常和Parse Server打交道的开发者，我完全理解你找不到完整Query Builder文档的头疼——官方文档确实有些地方不够细致，尤其是结合MongoDB的场景。下面我整理了一套实用的Query Builder核心用法和进阶技巧，帮你覆盖大部分常见查询需求：

• 获取单个对象：根据ObjectID精准查询，用get方法即可：

  const post = await new Parse.Query('Post').get('your-object-id-here');
  

• 获取多个对象：基础列表查询用find方法，默认返回前100条数据（Parse的默认限制）：

  const allPosts = await new Parse.Query('Post').find();
  

• 基础条件过滤：常用的过滤方法几乎覆盖了日常需求：
  • 精确匹配：equalTo('status', 'published')
  • 排除匹配：notEqualTo('category', 'spam')
  • 数值范围：greaterThan('views', 100)、lessThanOrEqualTo('publishedAt', new Date())
  • 数组包含：containedIn('tags', ['javascript', 'parse'])
  • 字符串模糊匹配：contains('title', 'guide')（大小写敏感），containsIgnoreCase('title', 'guide')（忽略大小写）

• 关联数据查询：
  • 对于Pointer类型字段，直接用equalTo就能关联查询关联表的数据：

    const user = await new Parse.Query('_User').get('user-id');
    const userPosts = await new Parse.Query('Post').equalTo('author', user).find();
    

  • 要预加载关联数据避免二次查询，用include方法：

    const postsWithAuthor = await new Parse.Query('Post').include('author').find();
    // 返回的每个post对象里会直接包含完整的author信息
    

• 排序与分页：
  • 排序：ascending('createdAt')实现升序，descending('views')实现降序，支持多字段链式排序：

    const sortedPosts = await new Parse.Query('Post').ascending('category').descending('publishedAt').find();
    

  • 分页：用skip跳过指定数量的结果，limit限制每页返回数（默认最大限制1000，可在Parse Server配置中修改maxLimit参数调整）：

    const paginatedPosts = await new Parse.Query('Post').skip(20).limit(10).find();
    

• MongoDB专属聚合查询：
  因为你用的是MongoDB，Parse Server支持直接调用MongoDB的聚合管道，通过aggregate方法实现复杂统计、分组需求：

  const statsPipeline = [
    { $match: { views: { $gt: 500 } } },
    { $group: { _id: '$category', total: { $sum: 1 }, totalViews: { $sum: '$views' } } }
  ];
  const categoryStats = await new Parse.Query('Post').aggregate(statsPipeline);
  

• 复合条件查询：用Parse.Query.or或Parse.Query.and组合多个查询逻辑：

  const highViewQuery = new Parse.Query('Post').greaterThan('views', 1000);
  const featuredQuery = new Parse.Query('Post').equalTo('isFeatured', true);
  // 满足任一条件
  const combinedQuery = Parse.Query.or(highViewQuery, featuredQuery);
  const results = await combinedQuery.find();
  

• 调试查询时，可以用toJSON()方法查看生成的查询结构，方便排查问题：

  console.log(new Parse.Query('Post').equalTo('author', user).toJSON());
  

• 注意ACL权限限制：Parse默认会自动应用对象的ACL规则，如果当前用户没有对应数据的访问权限，查询会返回空结果，这是新手很容易忽略的点。

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