当前位置：首页 > news >正文

解决Home Assistant Roborock集成常见问题：端口设置与设备连接排查

news 2026/7/21 8:44:58

解决Home Assistant Roborock集成常见问题：端口设置与设备连接排查

【免费下载链接】homeassistant-roborockRoborock integration for Home Assistant. This integration uses your devices from the Roborock App项目地址: https://gitcode.com/gh_mirrors/ho/homeassistant-roborock

Home Assistant Roborock集成允许用户将Roborock设备与Home Assistant系统无缝连接，实现智能控制和自动化。但在实际使用中，用户可能会遇到端口设置错误或设备连接失败等问题。本文将详细介绍如何排查和解决这些常见问题，帮助你快速恢复设备连接。

常见连接问题及表现

当Roborock设备无法连接到Home Assistant时，通常会出现以下几种情况：

认证失败：在配置流程中提示"auth"错误，无法完成登录验证
设备未找到：提示"no_device"错误，系统无法发现Roborock设备
主机不可达：设备IP地址或端口设置不正确导致连接超时
配置错误：网络设置或集成选项配置不当

这些问题主要与网络连接、端口设置或认证信息有关，通过系统排查通常可以解决。

端口与网络设置排查步骤

确认设备网络连接状态

首先确保Roborock设备已正确连接到家庭网络：

检查设备是否已成功连接到Wi-Fi，可通过Roborock官方App确认
确保设备与Home Assistant服务器在同一局域网内
尝试重启路由器和Roborock设备，刷新网络连接

手动配置设备IP与端口

如果自动发现功能失败，可以手动配置设备网络信息：

在Home Assistant中进入Roborock集成配置页面
选择"configure_device"选项
输入设备的IP地址和设备ID（可从Roborock App中获取）

配置文件路径：custom_components/roborock/config_flow.py中的DEVICE_SCHEMA定义了设备配置所需的参数，包括主机地址(CONF_HOST)和设备ID(CONF_DEVICE_ID)。

检查防火墙与端口占用情况

确保Home Assistant服务器的防火墙允许相关端口通信：

检查是否有防火墙规则阻止Home Assistant访问网络
确认Roborock设备所需端口未被其他应用占用
尝试关闭防火墙或添加例外规则测试连接

认证与登录问题解决

验证账号信息

Roborock集成支持两种认证方式：验证码登录和密码登录。如果遇到认证问题：

确认输入的用户名/邮箱正确无误
检查验证码是否及时输入（验证码通常有有效期）
尝试使用密码登录方式替代验证码登录

相关代码实现可参考custom_components/roborock/config_flow.py中的async_step_code和async_step_password方法。

重新授权流程

当认证信息过期或变更时，需要进行重新授权：

在Home Assistant集成页面找到Roborock集成
选择"重新配置"或"重新授权"选项
按照提示完成新的登录验证流程

高级排查技巧

查看系统日志

Home Assistant日志可以提供详细的错误信息：

在Home Assistant中开启调试日志，添加以下配置到configuration.yaml：
```
logger: default: info logs: custom_components.roborock: debug
```
查看日志文件中与Roborock相关的错误信息
根据日志提示定位具体问题