Python miio连接米家插座失败如何解决？

Question

使用Python miio库连接米家插座时，常见问题为“Authentication failed”或设备无响应。这通常因未正确获取设备的IP地址与token，或局域网通信受阻所致。确保设备已接入同一Wi-Fi网络，通过米家App或抓包工具准确提取token。同时，部分新固件限制第三方接入，需确认设备是否支持miio协议。防火墙或路由器设置也可能阻止UDP通信端口（默认54321），需检查并放行。

Answer 1

使用Python miio库连接米家插座的深度解析与解决方案

1. 问题现象与初步排查

在使用 python-miio 库控制米家智能插座时，开发者常遇到“Authentication failed”或设备无响应的问题。这类错误通常表现为：

• miio.exceptions.DeviceException: Authentication failed
• 设备返回空响应或超时（Timeout）
• 调用 device.info() 时抛出异常

初步判断应从网络连通性、设备状态和基础配置入手。

2. 核心要素：IP地址与Token获取

成功通信的前提是准确获取两个关键参数：

参数	作用	获取方式
IP 地址	局域网内定位设备位置	路由器后台、米家App设备详情页
Token	加密认证密钥，用于身份验证	抓包工具（如Charles）、本地备份提取、第三方脚本

注意：Token为32位十六进制字符串，若获取错误将直接导致认证失败。

3. 认证失败的深层原因分析

“Authentication failed”并非单一因素造成，其背后可能涉及多层机制：

1. Token格式错误或已过期（部分设备会周期性更换Token）
2. 设备运行新固件版本，启用了 miiocloud 模式，禁用局域网本地控制
3. 设备未完成初始化流程（如首次配网后需重启）
4. UDP端口54321被防火墙或路由器ACL规则阻断
5. Python环境中的 cryptography 库版本不兼容

4. 协议支持与固件限制检测

随着小米生态安全策略升级，部分新型号插座（如ZNCZ04LM新版）默认关闭miio本地协议支持。可通过以下方式确认：

from miio import Device

try:
    device = Device(ip="192.168.3.100", token="your_token_here")
    info = device.info()
    print(info.model)  # 输出设备型号
except Exception as e:
    print(f"连接失败: {e}")
    

若返回模型为未知或无法获取，则可能已被屏蔽本地访问。

5. 网络通信链路排查流程图

graph TD
            A[开始] --> B{设备与PC在同一Wi-Fi?}
            B -- 否 --> C[调整至同一子网]
            B -- 是 --> D[能否ping通设备IP?]
            D -- 否 --> E[检查ARP表/路由器隔离设置]
            D -- 是 --> F[UDP端口54321是否开放?]
            F -- 否 --> G[配置防火墙放行]
            F -- 是 --> H[尝试发送miio命令]
            H -- 失败 --> I[检查Token有效性]
            I --> J[使用抓包工具验证通信]
            J --> K[定位加密握手阶段异常]

6. 实际解决方案汇总

针对不同层级问题，提供如下应对策略：

• Token获取增强方案：使用 miio-extract-tokens 工具从手机备份中导出Token
• 固件降级或模式切换：通过ADB启用“开发模式”，关闭云优先策略
• 中间代理调试：部署 mitmproxy 抓取米家App与设备间UDP交互数据包
• Docker化测试环境：构建标准化Python环境避免依赖冲突
• 替代协议探索：对于不支持miio的设备，考虑接入Home Assistant并通过蓝牙或HTTP桥接

7. 高级调试技巧

当标准方法无效时，可采用底层调试手段：

import logging
logging.basicConfig(level=logging.DEBUG)

from miio import Plug

plug = Plug("192.168.3.100", "abXXXXXXXXXXXXXXXXXXXXXXXXXXXX")
try:
    print(plug.status())
except Exception as e:
    logging.error("Detailed error:", exc_info=True)
    

开启DEBUG日志后，可观察到完整的UDP请求/响应过程，包括AES加密前后载荷。