在配置Home Assitant时可能会遇到麻烦。 也许一个组件没有显示出来或者是表现奇怪。 本页将讨论一些最常见的问题。

在我们深入了解常见问题之前，请确保您知道配置目录在哪里。 Home Assitant 启动时将打印出使用的配置目录。

当组件或配置选项出现警告时，它将存储在配置目录中的 home-assistant.log 中。 该文件在Home Assistant启动时重置。



组件不显示

当一个组件不显示时，可能会有许多不同的情况。 在尝试任何这些步骤之前，请确保查看 home-assistant.log 文件，看看是否有与您尝试设置的组件相关的错误。

如果您的配置文件中有不正确的条目，您可以使用 check_config 脚本来帮助识别它们： hass --script check_config 。



配置问题

Home Assistant最常见的问题之一是无效的 configuration.yaml 文件。

  • 您可以使用以下命令行测试您的配置： hass --script check_config
  • 您可以使用在线 YAML 解析器或 YAML Lint 验证您的配置的yaml。
  • 要了解更多关于YAML的问题，请参阅SaltStack的 YAML IDIOSYNCRASIES （这些示例与SaltStack有关，但确实也很好的解释了YAML问题）。

configuration.yaml 不允许多个 sections 具有相同的名称。 如果要为一个组件加载多个平台，可以在名称中附加一个数字或字符串，或者使用此样式来嵌套它们：

sensor:
  - platform: forecast
    ...
  - platform: bitcoin
    ...

另一个常见的问题是缺少必需的配置项。 如果是这种情况，组件会将其报告给 home-assistant.log 。 有关如何设置组件的说明，可以查看各个组件页面。

有关如何定义特定模块所需的日志级别的说明，请参阅 logger 组件。

如果您发现任何错误或想要扩展文档，请告诉我们。



依赖问题

几乎所有组件都具有外部依赖关系以便与您的设备和服务通信。有时Home Assistant无法安装必要的依赖项。 如果是这种情况，它应该显示在 home-assistant.log 中。

第一步是尝试重新启动Home Assistant，看看问题是否仍然存在。 如果是，请查看日志以查看错误是什么。 如果你不明白，请报告，以便我们调查发生了什么。



组件问题

Home Assistant已经运行一段时间后，有些组件可能不能立即工作或停止工作。 如果发生这种情况，请报告，以便我们可以看看。



多个文件

如果您的配置使用多个文件，请确保指针正确，文件的格式有效。

light: !include devices/lights.yaml
sensor: !include devices/sensors.yaml

lights.yaml 的内容（注意它不包含 light: ）：

- platform: hyperion
  host: 192.168.1.98
  ...

sensors.yaml 的内容：

- platform: mqtt
  name: "Room Humidity"
  state_topic: "room/humidity"
- platform: mqtt
  name: "Door Motion"
  state_topic: "door/motion"
  ...

每当您报告问题时，请注意，我们的志愿者是无法访问世界上的每个设备，也不会无限制地修复每个问题。