Spring Boot项目MongoRepository的findAll()返回空列表问题排查求助

问题现象 #

在Spring Boot项目中，MongoRepository的findAll()方法返回空列表，但统计集合文档数量的API可正常工作，且其他查询方法（如findByScope）能返回有效结果。

相关代码 #

Controller代码 #

@RestController
@RequestMapping("/api/api-management/scopes")
public class AuthScopesController {
    private final ScopesService scopesService;

    @Autowired
    AuthScopesController(ScopesService scopesService) {
        this.scopesService = scopesService;
    }

    @PostMapping("/")
    public AuthScope createScope(@RequestBody AuthScope authScope) {
        return scopesService.createAuthScope(authScope);
    }

    @GetMapping("/")
    public List<AuthScope> getAllScopes() {
        return scopesService.getAuthScopes();
    }
}

Service代码 #

@Service
public class ScopesService {

    private final AuthScopeRepository authScopeRepository;

    public ScopesService(AuthScopeRepository authScopeRepository) {
        this.authScopeRepository = authScopeRepository;
    }

    public AuthScope createAuthScope(AuthScope authScope) {
        return authScopeRepository.save(authScope);
    }

    public List<AuthScope> getAuthScopes() {
        return authScopeRepository.findAll();
    }
}

Repository代码 #

@Repository
public interface AuthScopeRepository extends MongoRepository<AuthScope, String> {
    Optional<AuthScope> findByScope(String id);
}

实体类代码 #

@Data
@Document("auth-scopes")
public class AuthScope  {
    @Id
    private String scope;
    private String belongsToApi;
    private String belongsToApiTitle;
    private String description;
}

排查分析 #

从代码逻辑来看，核心问题集中在findAll()的文档映射环节，结合现象可从以下方向排查：

1. ID字段类型映射不匹配
   实体类用@Id标注了scope字段，意味着MongoDB文档的_id会与scope绑定。如果集合中存在_id为ObjectId类型而非字符串的文档，Spring Data MongoDB在映射时无法将ObjectId直接转换为String类型的scope，导致这类文档无法被正常实例化，最终findAll()返回空列表。而findByScope实际是按_id查询，传入的参数若为ObjectId的字符串形式，MongoDB会自动做类型转换，因此能查到结果。

2. 集合名称匹配问题
   需确认@Document("auth-scopes")指定的集合名称与MongoDB中实际集合名称完全一致（注意大小写、特殊字符），避免因名称不匹配导致findAll()查询空集合。

3. 映射配置异常
   检查是否存在自定义字段映射策略，比如强制要求字段严格匹配，若文档中存在实体类未定义的字段，可能导致映射失败。不过默认配置下，未定义字段会被忽略，不会直接导致整个列表为空。

解决建议 #

1. 检查MongoDB集合文档结构，确认所有文档的_id字段类型为字符串，与实体类scope字段类型匹配。若存在ObjectId类型的_id，可将实体类@Id字段改为ObjectId类型，或保存文档时显式设置scope字段的值。
2. 使用MongoTemplate直接查询验证，区分是MongoRepository逻辑问题还是映射问题：

   @Autowired
   private MongoTemplate mongoTemplate;
   
   public List<AuthScope> getAuthScopes() {
       return mongoTemplate.findAll(AuthScope.class);
   }
   

3. 在Service中添加日志，打印authScopeRepository.count()和findAll().size()的结果，确认数量是否匹配，排查是否真的未查询到数据。

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