HA登陆账号成功，进入小米Miot之后，没有设备或实体

[WalkeR-ZG]

Device model / 设备型号

Xiaomi Miot

Component version / 插件版本

1.1.2

HA core version / HA版本

2025.1.4

Integrated mode / 集成方式

Automatic (自动模式)

The problem / 问题详情

Entity attributes / 实体属性

无实体

Home Assistant Logs / 系统日志

log.txt

[github-actions]

遇到登录成功但无设备/实体的问题，通常与网络连接、DNS配置或设备筛选条件有关。请按以下步骤排查：

1. 检查集成日志（关键步骤）

进入 Home Assistant 日志筛选 miot 相关错误：

• 路径：配置 → 系统 → 日志 → 搜索框输入 miot
• 查看：逐条点开日志详情，重点关注最底部的错误信息

常见错误及解决方案：

日志错误特征	原因	解决方案
Name does not resolve / Name or service not known	DNS无法解析小米服务器	将DNS改为国内公共DNS（如阿里 223.5.5.5），检查路由器/Docker/HAOS的DNS设置
ReadTimeout / Connection reset	无法连接小米服务器	检查防火墙/代理/VPN，确保HA能访问 api.io.mi.com
Try again	网络不稳定	测试连通性：nslookup api.io.mi.com 和 curl -v https://api.io.mi.com

2. 验证网络连通性

在HA容器中执行以下命令测试：

# 进入HA容器（Docker/Supervised）
docker exec -it homeassistant sh

# 测试DNS解析
nslookup api.io.mi.com

# 测试HTTPS连接
curl -v https://api.io.mi.com

如果DNS解析失败，修改 /etc/resolv.conf 为：

nameserver 223.5.5.5
nameserver 114.114.114.114

3. 检查集成配置

• 重新配置集成：删除现有集成，重新添加时：

  • 选择 自动模式（推荐）
  • 在设备筛选步骤中，不要勾选任何筛选条件（留空以加载所有设备）
  • 确保小米账号下有已配网的设备

• 检查设备支持性：确认你的设备型号在支持列表中

4. 禁用IPv6（HAOS用户）

如果使用的是HAOS，尝试禁用IPv6：

• 路径：设置 → 系统 → 网络 → 点击当前网络 → 禁用IPv6

5. 检查账号权限

确保小米账号：

• 已绑定米家APP中的设备
• 未开启设备共享限制
• 服务器区域选择正确（中国大陆账号选cn）

6. 提供诊断信息

如果以上步骤无效，请提供：

1. 日志中完整的错误信息（文本形式）
2. 执行 nslookup api.io.mi.com 的结果
3. 设备型号（从米家APP查看）

快速验证：尝试临时关闭路由器/系统的全局代理或VPN，然后重启HA服务再试。

[Thuninisan]

我也碰到了同样的问题，环境：HA 2024.12.4 + xiaomi_miot v1.1.4。

原因应该是新版插件引用的 SearchMedia 在旧版 HA 底层库里不存在，导致集成初始化失败。

解决方案如下：

1. 对齐 Core 版本
将HA Core 版本更新为2026.3.2

2. 手动修改源码
临时方案，通过剔除缺失的引用绕过报错：

文件路径：/config/custom_components/xiaomi_miot/media_player.py

具体操作：找到第 28 行左右的导入语句，按下图方式修改：

Python
# 找到这一段，删掉或注释掉 SearchMedia 这一行
from homeassistant.components.media_player.browse_media import (
    BrowseMedia,
-   SearchMedia,  # <--- 删掉这一行
    async_process_play_media_url,
)

结果：保存并重启 HA 后，集成可正常加载。除了媒体搜索功能不可用外，所有实体控制逻辑全部恢复。

3. 其他解决方法
回滚miot版本