NullReferenceException em C#: como encontrar e corrigir o erro

O que é NullReferenceException e como lidar com ele? Guia completo para desenvolvedores C#

Você já viu aquela mensagem assustadora: "Object reference not set to an instance of an object"? Se você programa em C# há pelo menos uma semana, provavelmente já se deparou com ela. Este é o NullReferenceException — o erro mais popular no mundo .NET. Ele assusta iniciantes, mas desenvolvedores experientes sabem: é apenas a forma do programa dizer "Não sei com o que trabalhar, me dê um objeto".

Neste artigo, vamos analisar por que o NullReferenceException ocorre, como encontrá-lo e, principalmente, como preveni-lo. Você aprenderá a escrever um código mais seguro e gastar menos tempo em depuração.

O que é NullReferenceException em palavras simples?

Imagine que você pediu uma pizza, mas o entregador chegou de mãos vazias. Você pergunta: "Onde está minha pizza?", e ele responde: "Não sei, não tenho nada". É mais ou menos assim que funciona o NullReferenceException. Você tenta chamar um método ou acessar uma propriedade de uma variável que é igual a null. O compilador não vê isso, mas durante a execução o programa falha.

Em C#, qualquer variável de referência (classe, interface, string, array) pode ser null. Se você tentar fazer algo com essa variável, receberá uma exceção.

Os cenários mais comuns de ocorrência do NullReferenceException

Vamos ver exemplos reais de código que levam a esse erro.

1. Variável não inicializada

string name;\nConsole.WriteLine(name.Length); // NullReferenceException

A variável name foi declarada, mas não inicializada. Por padrão, ela é igual a null.

2. Método retorna null

public string GetUserName(int id)\n{\n    // se o usuário não for encontrado, retorna null\n    return null;\n}\n\nvar user = GetUserName(42);\nConsole.WriteLine(user.ToUpper()); // NullReferenceException

3. Acesso a um elemento de coleção que não existe

var list = new List<string> { "A", "B" };\nvar item = list[5]; // ArgumentOutOfRangeException, mas se o elemento fosse null...\n// Agora um exemplo com Dictionary:\nvar dict = new Dictionary<int, string>();\nvar value = dict[1]; // KeyNotFoundException, mas se a chave existisse e o valor fosse null?

4. Encadeamento de chamadas

class Address { public string City { get; set; } }\nclass Person { public Address Address { get; set; } }\n\nvar person = new Person();\nConsole.WriteLine(person.Address.City); // NullReferenceException, porque Address == null

Como encontrar NullReferenceException: depuração para iniciantes

Quando o programa falha, o Visual Studio ou Rider mostrarão a pilha de chamadas. Lá estará a linha onde o erro ocorreu. Mas muitas vezes o problema é mais profundo. Veja o algoritmo de busca:

\n
• Observe a linha com o erro. Qual variável está sendo usada? Ela com certeza não é null?
\n
• Verifique de onde veio o valor. Se for resultado de um método — veja se ele pode retornar null.
\n
• Use pontos de interrupção. Coloque um breakpoint antes da linha com erro e verifique os valores de todas as variáveis.
\n
• Adicione pontos de interrupção condicionais. No Visual Studio, você pode colocar um breakpoint com condição: myVar == null.
\n

Como corrigir NullReferenceException: 5 maneiras comprovadas

A boa notícia: o NullReferenceException quase sempre pode ser prevenido. Aqui está o que você pode fazer.

1. Verificação de null (o bom e velho if)

if (name != null)\n{\n    Console.WriteLine(name.Length);\n}\nelse\n{\n    Console.WriteLine("Nome não definido");\n}

Isso funciona, mas torna o código verboso se houver muitas verificações