Mora错误消息速查手册：常见异常解析与解决方法
【免费下载链接】Mora 
项目地址: https://gitcode.com/GitHub_Trending/mo/Mora
你是否在使用Mora时频繁遇到"API调用失败"或"生成任务中断"等问题？本文整理了8类高频错误场景，提供代码级解决方案和排查流程图，帮助你5分钟内定位问题根源。
错误类型总览
| 错误类别 | 占比 | 关联模块 |
|---|---|---|
| LLM服务异常 | 38% | mora/llm/ |
| 资源生成失败 | 27% | mora/actions/ |
| 配置参数错误 | 15% | mora/configs/ |
| 权限验证失败 | 12% | mora/agent/ |
| 其他异常 | 8% | - |
LLM服务异常处理
1. API密钥无效
错误特征：AuthenticationError: Invalid API key
触发场景：首次配置OpenAI/Azure服务时
解决步骤：
- 检查llm_config.py中
api_key字段是否为空 - 确认密钥格式是否匹配服务类型（OpenAI以
sk-开头，Azure包含resource信息） - 运行测试用例验证：
# 执行tests/test_llm.py验证配置
pytest tests/test_llm.py -k test_openai_api
2. 模型访问受限
错误特征：PermissionError: Model gpt-4 not available
解决方法：
- 企业用户联系管理员开通模型权限
- 个人用户在llm_config.py切换为可用模型（如
gpt-3.5-turbo）
资源生成失败
1. 图片生成超时
错误特征：TimeoutError: Image generation exceeds 60s
排查流程：
优化配置：在generate_image_with_text.py中调整：
# 将超时时间从60s延长至120s
TIMEOUT = 120
2. 视频衔接失败
错误特征：TransitionError: Frames mismatch
关联案例：task4_mora_rainbow.gif展示了帧序列异常的典型效果
解决方法：执行generate_transition.py重新计算帧过渡参数
配置参数错误
1. 路径格式错误
错误特征：FileNotFoundError: Path contains invalid characters
常见场景：Windows系统使用\作为路径分隔符
修复示例：
# 错误示例
path = "image\task1.gif"
# 正确写法
path = "image/task1.gif" # 使用正斜杠
2. 参数类型不匹配
错误特征：TypeError: Expected int but got str
检测工具：运行test_action.py进行类型校验
预防措施：在配置文件中添加类型注解：
# 在mora/configs/llm_config.py中
max_tokens: int = 2048 # 明确参数类型
权限验证失败
错误特征：AuthorizationError: Insufficient permissions
解决路径：
- 检查agent/role.py中的角色权限配置
- 确认当前用户拥有
generate:video权限 - 联系管理员执行权限刷新：
# 权限刷新示例代码
from mora.agent.role import Role
Role().refresh_permissions()
错误排查工具包
- 日志分析：查看tests/generated.png中的错误堆栈可视化
- 配置检测：运行mora/actions/add_requirement.py检查依赖完整性
- 流程验证：参考demo.py中的标准调用流程
问题反馈与支持
若遇到手册未覆盖的错误，请提交包含以下信息的issue：
- 完整错误堆栈截图
- 复现步骤（可参考demo.ipynb格式）
- 环境配置（执行
pytest --version获取）
提示：收藏本文档到本地，配合tests/目录下的测试用例，可实现90%常见错误的自主排查
【免费下载链接】Mora 项目地址: https://gitcode.com/GitHub_Trending/mo/Mora
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
