故障排查指南
这里包含了开发过程中常见问题的排查清单和解决方案。
📋 排查清单
通用问题
- 通用排查清单 - UI模块文件级排查清单，按具体文件组织的问题排查指南
特定功能问题
- 模板管理问题 - 参见归档文档 106-template-management
🔍 问题分类
应用启动问题
- 应用无法启动
- 白屏问题
- 服务初始化失败
组件渲染问题
- 模态框显示异常
- 组件状态错误
- 响应式数据问题
异步操作问题
- API调用失败
- 异步方法缺少await
- 时序问题
架构相关问题
- 依赖注入问题
- Composable使用错误
- 服务层问题
📝 使用说明
- 定位问题类型：根据问题现象确定属于哪个分类
- 查看对应清单：找到相关的排查清单文档
- 按步骤排查：按照清单逐项检查
- 记录解决方案：解决问题后更新相关文档
🔄 文档维护
- 每次解决新问题后，考虑更新相关排查清单
- 定期审查排查清单的有效性
- 将常见问题的解决方案添加到清单中
📞 获取帮助
如果排查清单无法解决问题：
- 查看相关的归档文档中的经验总结
- 在项目仓库提交Issue
- 联系项目团队
Source: docs/developer/troubleshooting/README.md