prompt-optimizer/docs/developer/troubleshooting

故障排查指南

这里包含了开发过程中常见问题的排查清单和解决方案。

📋 排查清单

通用问题

• 通用排查清单 - UI模块文件级排查清单，按具体文件组织的问题排查指南

特定功能问题

• 模板管理问题 - 参见归档文档 106-template-management

🔍 问题分类

应用启动问题

• 应用无法启动
• 白屏问题
• 服务初始化失败

组件渲染问题

• 模态框显示异常
• 组件状态错误
• 响应式数据问题

异步操作问题

• API调用失败
• 异步方法缺少await
• 时序问题

架构相关问题

• 依赖注入问题
• Composable使用错误
• 服务层问题

📝 使用说明

1. 定位问题类型：根据问题现象确定属于哪个分类
2. 查看对应清单：找到相关的排查清单文档
3. 按步骤排查：按照清单逐项检查
4. 记录解决方案：解决问题后更新相关文档

🔄 文档维护

• 每次解决新问题后，考虑更新相关排查清单
• 定期审查排查清单的有效性
• 将常见问题的解决方案添加到清单中

📞 获取帮助

如果排查清单无法解决问题：

1. 查看相关的归档文档中的经验总结
2. 在项目仓库提交Issue
3. 联系项目团队