Confirme o destino e a consulta
Comece confirmando qual conexão, banco e ambiente a consulta utiliza. Ambientes de desenvolvimento e produção podem ter nomes parecidos, mas dados diferentes. Verifique o nome da tabela ou coleção e se a conta conectada tem permissão para lê-la; uma conexão bem-sucedida não garante que ela aponte para os dados esperados.
Em seguida, examine temporariamente filtros e condições. Um intervalo de datas, uma correspondência exata ou várias condições combinadas podem excluir todos os registros mesmo quando há dados na coleção. Compare a consulta com um registro conhecido e adicione os filtros novamente um de cada vez para descobrir qual altera o resultado.
Diferencie dados ausentes de falta de acesso
Se uma leitura mais simples ainda não retornar nada, confirme pelo caminho usual de administração ou aplicação se os registros esperados existem. Se existirem ali, mas não pela conexão, investigue permissões, seleção do esquema e ambiente antes de tentar gravar ou alterar amplamente a consulta.
Mantenha a investigação somente de leitura até entender a divergência. Registre a conexão e a consulta que geraram o resultado vazio, além do ambiente de destino. Esse contexto facilita reproduzir o problema e evita que uma alteração de diagnóstico afete o banco errado.