# 配置校验与错误排查
#### Entry_point错误场景
表1错误场景 
| 错误                                                           | 原因            | 解决                                          |
|:---|:---|:---|
| ``` ValueError: Unsupported hardware.type 'xxx' ```          | type未注册。      | 确认包已安装，检查AdapterRegistry.available_types()。 |
| ``` ValueError: Failed to load adapter entry_point 'xxx' ``` | 工厂函数import失败。 | 检查模块路径、函数名是否正确、依赖是否安装。                      |
| ``` TypeError: Adapter factory returned ... ```              | 工厂返回值类型错误。    | 工厂必须返回IRobotHardwareAdapter实例。              |
| entry_point不生效                                               | 同名被覆盖。        | 使用独特前缀命名（如vendor_robot）。                    |
| transformer不生效                                               | 与内置同名冲突。      | 检查日志is ignored because a builtin。           |
   
#### 从class_path偏移
```
# 旧格式（已弃用）
hardware:
  type: custom
  class_path: "mypackage.MyAdapter"
  custom_config: {ip: "192.168.1.xxx"}
# 新格式
hardware:
  type: my_robot
  config: {ip: "192.168.1.xxx"}
```
#### xxx_config迁移
```
# 旧格式（已弃用）
hardware:
  type: dummy
  dummy_config: {...}
# 新格式
hardware:
  type: dummy
  config: {...}
```