Spring Data MongoDB中@Query指定返回字段无效的问题排查

嗨，我来帮你梳理排查下这个问题~ 你遇到的情况是明明用@Query的fields指定了要返回的字段，但接口还是返回了整个文档（包括那些值为null或0的字段），咱们一步步来拆解可能的原因：

首先，先确认最基础的查询映射和语法问题：

• 先核对@Query里fields的字段名和MongoDB集合里的实际字段名是否完全一致？比如实体类里的siteUrl，数据库里是不是叫siteUrl？如果数据库用的是下划线命名（比如site_url），那实体类对应的字段需要加上@Field("site_url")注解做映射，不然Spring Data找不到对应字段，投影规则自然不生效。
• 你可以直接用MongoDB Shell执行对应的查询语句，验证数据库本身返回的结果是否符合预期：

  db.sites.find({clientId: 你的测试ID}, {clientId:1, siteUrl:1, siteName:1, dateAdded:1})
  

  如果Shell返回的结果是只有指定字段，那问题就出在Spring Data处理或序列化环节；如果Shell也返回全字段，那大概率是字段名拼写错误或者投影语法有问题（不过你写的语法看起来是正确的）。

接下来，排查Spring Data和实体类的潜在问题：

• 检查你的sites实体类，那些不需要返回的字段有没有被初始化默认值？比如如果某个字段是private String remark = "";，那即使数据库没返回这个字段，实体类对象里该字段也会有默认值，序列化的时候就会被输出出来。这种情况可以给这些字段加@JsonIgnore注解，让Jackson序列化时忽略它们。
• 试试暂时去掉Pageable，改用List<sites> findByClientId(Object clientId);来查询，看看返回的列表里的实体对象是不是只有指定字段有值？如果是，那可能是Page对象的序列化逻辑导致的，你可以查看Page.getContent()里的实体字段情况，确认是不是真的没拿到多余字段。
• 有没有可能是Spring Data MongoDB的版本问题？有些旧版本在结合Pageable和@Query投影时存在bug，你可以尝试升级到较新的稳定版本试试。
• 另外，检查下你的实体类有没有继承父类？如果父类里有其他字段，这些字段可能会被默认序列化出来，这时候需要在投影里明确排除，或者给父类的字段加@JsonIgnore。

最后，再核对下你的service层代码：你把client.getId()（int类型）转成long传给repository，虽然查询能匹配到数据，但最好确认下MongoDB里的clientId字段类型是不是long，避免类型不匹配导致的潜在问题。

备注：内容来源于stack exchange，提问作者vbNewbie