Home Assistant中MQTT开关实体被隐藏，无法添加至仪表盘求助

方案1：通过MQTT自动发现配置实体 #

Home Assistant的MQTT集成默认依赖自动发现识别设备，仅发送available和state主题不足以让HA识别为标准开关实体，需额外发送配置主题：

发布以下配置消息（可根据实际需求调整参数）：

client.publish("homeassistant/switch/bedroom/switch1/config", 
               '{"name": "Bedroom Switch 1", "state_topic": "home/bedroom/switch1/state", "command_topic": "home/bedroom/switch1/command", "availability_topic": "home/bedroom/switch1/available", "payload_on": "on", "payload_off": "off", "payload_available": "online", "payload_not_available": "offline"}',
               retain=True)

• 配置主题需遵循homeassistant/<domain>/<object_id>/config的规范，HA会自动识别并创建实体
• 添加retain=True确保HA重启后仍能读取到配置信息
• 必须补充command_topic，用于HA发送控制指令，你的设备需要监听该主题执行开关动作

方案2：手动在HA配置文件中添加MQTT开关 #

若不想使用自动发现，可直接在configuration.yaml中添加实体配置：

switch:
  - platform: mqtt
    name: "Bedroom Switch 1"
    state_topic: "home/bedroom/switch1/state"
    command_topic: "home/bedroom/switch1/command"
    availability_topic: "home/bedroom/switch1/available"
    payload_on: "on"
    payload_off: "off"
    payload_available: "online"
    payload_not_available: "offline"

配置完成后重启Home Assistant，实体将出现在实体列表中

方案3：取消实体隐藏（适用于已被HA识别但隐藏的情况） #

如果实体已存在但被标记为隐藏，可按以下步骤显示：

1. 进入Home Assistant的设置 → 设备与服务 → 实体
2. 打开右上角显示选项，勾选显示已禁用的实体和显示已隐藏的实体
3. 找到目标实体switch.bedroom_switch_1，进入详情页
4. 点击右上角编辑图标，取消勾选隐藏实体，保存后即可添加到仪表盘

内容的提问来源于stack exchange，提问作者s_s