Swift中Parse PFQuery查询MongoDB无结果（equalTo/contains失效）求助

我之前用Parse开发iOS应用时也碰到过几乎一模一样的问题，折腾了好一阵才找到根源，给你几个排查方向，应该能解决：

1. 大小写匹配问题（最常见的坑） #

Parse的contains方法是严格区分大小写的！如果数据库里的游戏名称是ticket to ride全小写，而你搜索的是首字母大写的Ticket to Ride，就会直接查不到结果。

解决办法很简单，换成不区分大小写的匹配：

// 替换原来的contains方法
gamesQuery.whereKey("name", containsIgnoringCase: gameTitle)

或者用正则表达式实现更灵活的匹配：

// 正则匹配，i表示不区分大小写
gamesQuery.whereKey("name", matchesRegex: gameTitle, modifiers: "i")

2. 检查Parse Class的权限设置 #

Parse默认会限制公共数据的查询权限，如果你的games类没有开启Find权限，哪怕数据真实存在，客户端也会返回空结果。

去你的Parse Dashboard找到games类，进入「Security」标签，确保「Find」权限设置为「Public」（开发阶段可以先这么配置，上线后再根据需求调整为角色权限）。

3. 确认字段类型与索引有效性 #

虽然你说已经给name字段建了索引，但要确保：

• 字段类型是String，不是Number、Array这类其他类型
• Parse的contains是子字符串匹配，依赖的是普通单字段索引，而非MongoDB的文本索引。可以在Robo 3T里重新确认索引，或者直接在MongoDB终端重建一次：

  db.games.createIndex({name: 1})
  

4. 排查搜索词的特殊字符/空格问题 #

如果数据库里的名称有多余空格（比如Ticket to Ride两个空格），而你的搜索词是Ticket to Ride（单个空格），contains会匹配失败。可以先对搜索词做预处理：

// 去除首尾空格，替换中间多个空格为单个空格
let trimmedTitle = gameTitle.trimmingCharacters(in: .whitespacesAndNewlines)
let normalizedTitle = trimmedTitle.replacingOccurrences(of: "\\s+", with: " ", options: .regularExpression)
gamesQuery.whereKey("name", containsIgnoringCase: normalizedTitle)

5. 先测试精确匹配，缩小问题范围 #

先把查询改成精确匹配，确认基础查询链路是否正常：

gamesQuery.whereKey("name", equalTo: "Ticket to Ride")

如果这个能查到结果，说明问题出在模糊匹配逻辑上；如果连精确匹配都查不到，就要检查：

• className是否完全正确（Parse会自动将类名转为小写复数，比如Game类对应games集合，你代码里用的games是对的）
• 数据库里的字段名是不是真的叫name（有没有拼写错误，比如Name或者gameName）
• 查看Heroku上的Parse Server日志，看有没有查询错误：
  在终端执行：

  heroku logs --tail
  

  检查请求日志里有没有权限错误、字段不存在这类提示。

按照这些步骤排查，应该能很快定位到问题！

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