From 09bf82da9aea8bd499bbb09b5fc9357955aa617a Mon Sep 17 00:00:00 2001 From: impressionyang Date: Wed, 15 Apr 2026 19:03:59 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E9=97=AE=E9=A2=98?= =?UTF-8?q?=E4=BF=AE=E5=A4=8D=E8=AE=B0=E5=BD=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 记录 2026-04-15 配置向导 500 错误的修复过程 Co-Authored-By: Claude Opus 4.6 --- 问题修复记录.md | 54 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 54 insertions(+) create mode 100644 问题修复记录.md diff --git a/问题修复记录.md b/问题修复记录.md new file mode 100644 index 0000000..2427624 --- /dev/null +++ b/问题修复记录.md @@ -0,0 +1,54 @@ +# 问题修复记录 + +## 2026-04-15: 修复配置向导 500 错误 + +### 问题描述 +添加集成时出现 500 Internal Server Error + +### 根本原因 +1. **类型注解错误**：`config_flow.py` 使用了小写 `any` 而非 `Any` +2. **依赖包不存在**：`manifest.json` 中引用了不存在的 `bleak-mesh>=0.2.0` + +### 错误日志 +``` +homeassistant.requirements.RequirementsNotFound: +Requirements for sigmesh_gateway not found: ['bleak-mesh>=0.2.0']. +``` + +### 解决方案 + +#### 修复 1: config_flow.py 类型注解 +```diff ++ from typing import Any + +- async def async_step_user(self, user_input: dict[str, any] | None = None) -> FlowResult: ++ async def async_step_user(self, user_input: dict[str, Any] | None = None) -> FlowResult: + +- async def async_step_init(self, user_input: dict[str, any] | None = None) -> FlowResult: ++ async def async_step_init(self, user_input: dict[str, Any] | None = None) -> FlowResult: +``` + +#### 修复 2: manifest.json 依赖 +```diff +- "requirements": ["pyserial-asyncio==0.6", "bleak-mesh>=0.2.0"], ++ "requirements": ["pyserial-asyncio-fast>=0.6"], +``` + +### 提交记录 +| Commit | 说明 | +|--------|------| +| 66b86e3 | fix: 修复 config_flow.py 类型注解错误 | +| e905410 | fix: 修复 manifest.json 依赖错误 | + +### 部署步骤 +```bash +# 复制更新后的集成文件 +cp -r /home/ubuntu/workspace/cherry-studio/enginneer/impress_sig_mesh_hacs/custom_components/sigmesh_gateway \ + /custom_components/ + +# 重启 Home Assistant +ha core restart +``` + +### 验证 +重启后，在 HA UI 中重新尝试添加集成，应能正常显示配置表单。