Antes de tudo, confira
- Verifique se o erro começou após uma mudança específica.
- Leia as 5 a 10 linhas anteriores à mensagem final.
- Confirme se o erro cita Core, Supervisor, add-on ou custom_components.
- Valide YAML antes de reiniciar.
- Teste o serviço em Ferramentas do Desenvolvedor > Ações.
- Procure códigos 401, 403, timeout e unavailable.
Soluções, da mais provável à menos
Corrigir YAML inválido
Por que acontece: Indentação, campo antigo, aspas ou estrutura incorreta no arquivo de configuração.
- Abra o arquivo editado por último.
- Use a validação de configuração do Home Assistant.
- Corrija a linha indicada e as linhas próximas.
- Reinicie apenas depois da validação passar.
Reautenticar integração
Por que acontece: Token expirado, senha alterada ou serviço externo exigindo nova autorização.
- Abra Dispositivos e Serviços.
- Procure alerta de reautenticação.
- Atualize credenciais ou token.
- Verifique se as entidades voltaram a atualizar.
Isolar custom component
Por que acontece: Integração instalada por HACS ou manualmente incompatível com a versão atual do Home Assistant.
- Atualize o componente pelo HACS.
- Leia issues do repositório.
- Desative a integração temporariamente.
- Reinicie e confirme se o erro some.
Corrigir chamada de serviço
Por que acontece: Automação chama serviço renomeado ou envia dados em formato inválido.
- Abra Ferramentas do Desenvolvedor > Ações.
- Monte a chamada pela interface.
- Copie o formato correto para a automação.
- Teste com uma entidade não crítica.
No começo, o Home Assistant era quase todo YAML e arquivo de log. Hoje a interface esconde muita coisa, mas o log continua sendo o lugar onde a casa confessa o que está errado. Às vezes com elegância. Às vezes em 40 linhas vermelhas que parecem ameaça jurídica.
A própria documentação de troubleshooting resume bem o primeiro passo: “look at the log to see what the error is”. Curto, seco e correto. O erro é que muita gente lê só a última linha. Quase sempre, a pista boa está duas ou três linhas acima.
O erro começou depois de mexer em YAML?#
Se começou depois de editar configuration.yaml, automations.yaml ou templates, pare de reiniciar. Valide configuração primeiro. Erros de indentação, dois-pontos faltando e aspas tortas não melhoram com reboot. O Home Assistant costuma apontar arquivo e linha aproximada; não trate isso como sentença exata, mas como quarteirão do incêndio.
A integração está indisponível ou o token venceu?#
Erro de autenticação aparece muito em integrações de nuvem, energia, câmeras e APIs externas. Procure mensagens com 401, 403, unauthorized, invalid token ou reauth. A solução não é apagar integração de primeira. Tente reautenticar, atualizar credencial e confirmar se o serviço externo está online.
O log fala em dependência que não instalou?#
Quando uma integração precisa de biblioteca externa e ela falha, o log costuma citar dependency, pip, install ou import error. Isso aparece mais em custom components e instalações com ambiente travado. Aqui, reiniciar cinco vezes é só fazer barulho. Atualize o componente, confira versão do Home Assistant e veja se a integração ainda é mantida.
A automação chamou um serviço errado?#
Service not found, extra keys not allowed e expected dict são os clássicos. Eles indicam serviço renomeado, dado no formato errado ou ação montada com campo antigo. Abra Ferramentas do Desenvolvedor, Ações, procure o serviço e monte a chamada por ali antes de voltar para a automação.
O problema vem de HACS ou custom integration?#
Custom component é onde a diversão costuma virar boleto. Se o erro menciona custom_components, teste desativar temporariamente a integração, atualizar pelo HACS e ler o repositório do projeto. Não culpe o Core antes de isolar o código externo.
Log bom não é log vazio. Casa conectada sempre reclama de alguma coisa. O objetivo é separar aviso tolerável de erro que derruba automação. Se o mesmo erro aparece a cada minuto, ele já deixou de ser ruído.