O que significa um erro de compilação "não consegue encontrar o símbolo"?

1. O que significa um erro de "não encontrar o símbolo"?

O seu código fonte Java consiste nas seguintes coisas:

Palavras-chave:true, false, class, while, e assim por diante.
• literais: como 42 e 'X' e "Hi mum!".
• operadores e outros tokens não alfanuméricos: semelhantes +, =, {, e assim por diante.
Identificadores: Tipo Reader, i, toString, processEquibalancedElephants, e assim por diante. Comentários e espaços em branco.

Um erro de" incapaz de encontrar o símbolo " é sobre os identificadores. Quando o seu código é compilado, o compilador precisa de descobrir o que cada identificador do seu código significa.

Um erro de "não encontrar o símbolo" significa que o compilador não pode fazer isto. O seu código parece estar a referir-se a algo que o compilador não compreende.

2. O que pode causar um erro de "não encontrar o símbolo"?

• para identificadores em geral:
  Talvez tenhas escrito o nome incorrectamente; ou seja StringBiulder em vez de StringBuilder. Java não pode e não vai tentar compensar por erros de ortografia ou digitação.
Talvez tenhas percebido mal o caso, ou seja, em vez de StringBuilder. Todos os identificadores Java são sensíveis a maiúsculas.
• talvez tenhas usado sublinhados inadequadamente; isto é, mystring e my_string são diferentes. (Se você se cingir às regras de estilo Java, você será amplamente protegido deste erro ...)
Talvez estejas a tentar usar algo que foi declarado "em algum outro lugar", ou seja, em um contexto diferente para onde você disse implicitamente ao compilador para olhar. (Uma classe diferente? Um âmbito diferente? Um pacote diferente? Uma base de código diferente?)

String s = String();  // should be 'new String()'

O problema é muitas vezes uma combinação dos anteriores. Por exemplo, talvez você "star" importou java.io.* e então tentou usar a classe Files... que está em java.nio Não java.io. Ou talvez quisesses escrever ... que é {[86] } uma classe em java.io.

Aqui está um exemplo de como o escopo variável incorreto pode levar a um erro de "não encontrar símbolo":

for (int i = 0; i < strings.size(); i++) {
    if (strings.get(i).equalsIgnoreCase("fnoord")) {
        break;
    }
}
if (i < strings.size()) {
    ...
}

Isto dará um erro de "não encontrar o símbolo" para i na declaração if. Embora tenhamos declarado anteriormente i, essa Declaração está apenas no âmbitopara a declaração for e para o seu corpo. A referência a i na declaração if não consegue ver essa Declaração de i. Está fora do âmbito de aplicação.

A correção apropriada aqui pode ser mover a indicação if dentro do laço, ou declarar i antes do início do laço.)

for (int i = 0; i < 100; i++); {
    System.out.println("i is " + i);
}

Isto dar-lhe-á um erro de compilação na chamada println dizendo que i Não pode ser encontrado. Mas eu declarei-o!

O problema é o ponto e vírgula sorrateiro antes do {. A linguagem Java define que é uma declaração vazia. Então esse código realmente significa isto:

for (int i = 0; i < 100; i++); 

{
    System.out.println("i is " + i);
}

O bloco { ... } não é o corpo do laço for, por isso a declaração de i não está no âmbito no bloco.

Aqui está outro exemplo de erro de" Cannot find symbol " que é causado por um erro tipográfico.

int tmp = ...
int res = tmp(a + b);

Apesar da declaração anterior, a expressão tmp na expressão tmp(...) está errada. O compilador vai procurar um método chamado tmp, e não vai encontrar um. O tmp anteriormente declarado está no espaço de nomes para variáveis, não no espaço de nomes para métodos.

int res = tmp * (a + b);

Existe outra razão pela qual o compilador pode não encontrar um símbolo se estiver a compilar a partir da linha de comandos. Você pode simplesmente ter esquecido de compilar ou recompilar alguma outra classe. Por exemplo, se classes Foo e Bar em que Foo se utiliza Bar. Se nunca compilou Bar e executa javac Foo.java, é provável que descubra que o compilador não consegue encontrar o símbolo Bar. A resposta simples é para Foo e Bar juntos; por exemplo javac Foo.java Bar.java ou javac *.java. Ou melhor ainda usar uma ferramenta de construção Java; por exemplo, Ant, Maven, Gradle e assim por diante.

3. Como posso corrigir esses erros ?

• veja a linha do ficheiro indicada pela mensagem de erro de compilação.
• identifique o símbolo de que a mensagem de erro está a falar.
• descubra porque o compilador está a dizer que não consegue encontrar o símbolo; veja acima!

Note que nem toda a "correcção" está correcta. Considere isto:

for (int i = 1; i < 10; i++) {
    for (j = 1; j < 10; j++) {
        ...
    }
}

Suponha que o compilador diz "não consegue encontrar o símbolo" para j. Há muitas maneiras que eu poderia "corrigir" que:

Eu poderia mudar o interior para {[[40]} - provavelmente correto. Podia acrescentar uma declaração para j antes de o laço interior for, ou o laço exterior for - possivelmente correcto. Eu podia mudar para ... No laço interior, provavelmente errado! E assim por diante.

4. Causas obscuras

1. Dependências incorrectas: se estiver a usar um IDE ou uma ferramenta de compilação que gere a localização de compilação e dependências de projeto, você pode ter cometido um erro com as dependências; por exemplo, deixou de fora uma dependência, ou selecionou a versão errada. Se estiver a usar uma ferramenta de compilação (Ant, Maven, Gradle, etc), verifique o ficheiro de compilação do projecto. Se estiver a usar um IDE, verifique a configuração do caminho de compilação do projecto.

2. Você não está recompilando: às vezes acontece que os novos programadores Java não entendem como a cadeia de ferramentas Java funciona, ou não implementaram um repetível "processo de construção"; por exemplo, usando uma IDE, Formiga, Maven, graxa e assim por diante. Em tal situação, o programador pode acabar perseguindo sua cauda em busca de um erro ilusório que é na verdade causado por não recompilar o código corretamente, e assim por diante ...

3. Um problema de compilação anterior: é possível que uma compilação anterior tenha falhado de uma forma que tenha dado um ficheiro JAR com classes em falta. Tal falha seria tipicamente notada se você estivesse usando uma ferramenta de construção. Entanto se você está recebendo arquivos JAR de outra pessoa, você está dependente de eles construir corretamente, e notar erros. Se suspeitar disto, use tar -tvf para listar o conteúdo do ficheiro JAR suspeito.

4. Questões IDE: as pessoas relataram casos em que a sua IDE fica confusa e o compilador na IDE não consegue encontrar uma classe que exista ... ou a situação inversa.

   • Isto pode acontecer se os esconderijos da IDE ficarem fora de sincronia com o ficheiro sistema. Há formas específicas de corrigir isso.

   • Isto pode ser um erro de IDE. Por exemplo, @Joel Costigliola descreve um cenário em que o Eclipse não lida corretamente com uma árvore de "teste" Maven: veja esta resposta.

5. Redefinindo classes do sistema : já vi casos em que o compilador reclama que substring é um símbolo desconhecido em algo como o seguinte

   String s = ...
   String s1 = s.substring(1);
   

   [84] programador tinha criado sua própria versão de String e que sua versão da classe não definia um método substring. Lição: não definas as tuas próprias aulas com os mesmos nomes que as classes comuns da biblioteca!

6. Homógrafos: Se você usar a codificação UTF-8 para os arquivos de origem, é possível ter identificadores que olhar o mesmo, mas na verdade são diferentes porque eles contêm homógrafos. Ver esta página para mais informações.

   Você pode evitar isso restringindo - se a ASCII ou Latin-1 como a codificação de arquivo fonte, e usando Java \uxxxx escapa para outros caracteres.

^{1 - Se, por acaso, você do ver isto numa excepção em tempo de execução ou numa mensagem de erro, então ou configurou o seu IDE para executar o código com erros de compilação, ou a sua aplicação está a gerar e a compilar o código .. no tempo de execução.}