Introduction : un cas bien réel

Dans le cadre d’une installation domotique autour de la gestion solaire d’un chauffe-eau, plusieurs automatismes ont été écrits à la main en YAML. Si cette méthode offre souplesse et contrôle, elle expose également à des erreurs faciles à commettre mais parfois longues à déboguer.

Voici une série de problèmes rencontrés lors de ce projet, avec leur origine exacte et la solution appliquée pour les corriger.

Des IDs d’automatisations en double : « ID already exists »

Problème

En copiant plusieurs automatisations à la main (ou via l’interface), le même ID a été utilisé plusieurs fois. Cela empêchait certaines automatisations de s’activer, sans message très clair dans l’interface.

Symptômes

• Message dans les logs : ID ce_surplus_solaire already exists
• Une des automatisations ne se déclenche jamais

Solution

Aller dans Paramètres > Automatisations > éditer chaque YAML et vérifier que id: est bien unique pour chaque automatisation.

Ou supprimer la ligne id: pour laisser Home Assistant la régénérer automatiquement.

Mauvaise référence d’entité : sensor inexistant

Problème

Une automatisation contenait :

entity_id: sensor.envoy_current_net_power_consumption

Or cette entité n’existait pas. Le bon nom était :

sensor.envoy_122326133494_current_net_power_consumption

Symptômes

• Message : unknown entity dans les logs
• L’automatisation ne se déclenche jamais, même si toutes les conditions sont réunies

Solution

Aller dans Outils de développement > États et copier le nom exact de l’entité.
Ne jamais se fier au nom affiché en interface ou sur les badges Lovelace.

Déclencheurs mal structurés : erreurs de clefs YAML

Problème

L’utilisation incorrecte de blocs trigger: avec des clés invalides (écriture en double, mauvais type ou indentation) provoquait des erreurs silencieuses.

Exemple erroné :

triggers:
  - at: "13:00:00"
    trigger: time

Au lieu de :

trigger:
  - platform: time
    at: "13:00:00"

Symptômes

• L’automatisation semble présente, mais ne s’exécute jamais
• Aucun log d’erreur clair

Solution

Toujours tester les automatisations via le bouton « Vérifier la configuration » (dans Paramètres > Système > Contrôle du serveur).
Et en cas de doute : basculer temporairement l’automatisation en mode graphique pour vérifier sa structure YAML.

Mauvaise complétion ou renommage en double

Certains éditeurs (VS Code, Studio Code Server) proposaient des complétions automatiques erronées (entités obsolètes, renommées, ou doublons précédemment supprimés).

Recommandation

Passer par l’interface de Home Assistant pour copier l’ID précis des entités, ou utiliser Outils de développement > États.

Conclusion

Ce retour d’expérience montre que la création manuelle d’automatisations dans Home Assistant est puissante, mais exposée à des erreurs discrètes : identifiants dupliqués, entités mal orthographiées, déclencheurs invalides.

Le réflexe à adopter : vérifier dans les outils de développement, tester chaque automatisation isolément, et s’assurer de l’unicitié des IDs.

En cas de doute, ou pour une relecture de vos automatisations avant mise en production, n’hésitez pas à nous contacter.