impressionyang/impress_sig_mesh_hacs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 添加问题修复记录

Browse Source 
记录 2026-04-15 配置向导 500 错误的修复过程

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
impressionyang 2026-04-15 19:03:59 +08:00
parent e905410ed7
commit 09bf82da9a
1 changed files with 54 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

54
问题修复记录.md Normal file
View File

@ -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 \
<HA 配置目录>/custom_components/
# 重启 Home Assistant
ha core restart
```
### 验证
重启后，在 HA UI 中重新尝试添加集成，应能正常显示配置表单。