错误码表
字数
1881 字
阅读时间
7 分钟
本节会将 ChatLuna 里的常见错误码列出，并给出某些可能的解决方案。
警告
如果尝试了下面的解决方案后仍然无效，请联系开发者以解决问题（需要提供错误日志）。
| 错误码 | 含义 | 可能的解决方案 |
|---|---|---|
| 1 | 网络错误 | 检查代理配置，网络连接是否正常、 |
| 2 | 不支持的代理协议 | 检查代理配置，是否选择了正确的协议 (只支持 http/sock5) |
| 3 | 队列溢出 | 大量请求！难得 ChatLuna 能被这么多人用呢。。 |
| 4 | 渲染出错 | 根据当前会话的渲染模式，检查 Puppeteer 浏览器渲染配置、语音服务等。 |
| 5 | 请求被中断 | 一般是用户手动调用 chatluna.chat.stop 中断的，无需处理 |
| 100 | API KEY 无效 | 检查 API KEY 是否可用。 |
| 101 | 请求时需要验证码 | 手动登录相关网页过验证码。 |
| 102 | 请求超时 | 检查网络连接和代理配置是否正常，检查 API KEY 是否可用。 |
| 103 | API 请求失败 | 检查网络连接和代理配置是否正常，检查 API KEY 是否可用。 |
| 104 | 不安全的请求内容 | 和模型聊天时使用了不安全的词语，尝试执行 chatluna.new 创建新会话后重试。 |
| 300 | 模型适配器未找到 | 检查模型适配器是否有启用。 |
| 301 | 模型未找到 | 检查模型是否可用，模型适配器是否初始化成功。 |
| 302 | 预设未找到 | 检查当前会话或路由规则中的目标预设是否存在，检测预设格式是否正确。 |
| 303 | 模型初始化失败 | 检查模型配置是否正确，检查网络和代码配置是否正常。 |
| 304 | 嵌入模型初始化失败 | 检查模型配置是否正确，检查网络和代码配置是否正常。 |
| 305 | 向量数据库加载失败 | 检查向量数据库配置是否正确，检查网络和代码配置是否正常。 |
| 306 | 聊天记录初始化失败 | 检查是否正确配置了 Koishi 的数据库。 |
| 307 | 没有可用的配置 | 可以先执行 chatluna.new 创建新会话后再试。如果不行，检查所有模型、嵌入模型、向量数据库配置是否正确。 |
| 308 | 初始化会话加载失败 | 同 101, 103。 |
| 309 | 模型返回为空 | 同 101、103，并检查对话内容和预设是否有不合适的内容。对于不合适的内容，模型可能不会生成回复。可以先执行 chatluna.new 创建新会话后再试。 |
| 310 | 模型关闭异常 | 同 309，如果按 309 无解决需要上报给开发者。 |
| 311 | 预设加载失败 | 检查预设是否存在，检查预设语法相关是否正确。 |
| 312 | 长期记忆初始化失败 | 检查长期记忆插件配置、数据库和相关模型配置。 |
| 313 | 向量数据库未启用 | 检查向量数据库服务是否已安装并启用。 |
| 314 | 向量数据库嵌入失败 | 检查嵌入模型和向量数据库配置是否匹配。 |
| 315 | 向量维度不匹配 | 确认当前向量数据库和嵌入模型使用同一套配置，必要时重建索引。 |
| 316 | 重排序模型初始化失败 | 检查重排序模型配置是否正确，或暂时关闭重排序功能。 |
| 400 | 成员不在目标会话上下文中 | 检查当前路由或共享设置是否正确。 |
| 401 | 未加入目标上下文 | 检查当前路由解析结果，或重新创建新会话。 |
| 402 | 旧房间迁移数据异常 | 清理旧数据或联系开发者排查迁移问题。 |
| 403 | 模版会话配置错误 | 检查默认模型、默认预设、默认聊天模式等配置项并重新保存。 |
| 404 | 有多个会话使用了同一个名字 | 优先使用会话 ID，或重命名其中一个会话。 |
| 405 | 会话不存在 | 检查会话是否存在，或创建一个新会话。 |
| 406 | 初始化默认会话失败 | 一般情况下重新发起一次新会话即可解决，如果仍未解决请反馈给开发者。 |
| 410 | 目标会话匹配到多条结果 | 使用 chatluna.list 查看序号，或改用会话 ID 精确指定。 |
| 411 | 目标会话不属于当前路由 | 检查当前群聊/私聊路由、预设通道和共享授权设置。 |
| 412 | 未找到目标会话 | 检查会话是否存在、是否已归档，必要时加上 -a 或 --all。 |
| 413 | 缺少会话管理权限 | 使用管理员账号操作，或调整当前路由的管理权限。 |
| 414 | 当前规则锁定了会话操作 | 检查 chatluna.rule.show 中的锁定状态，必要时由管理员解锁。 |
| 415 | 当前路由禁用了该会话操作 | 检查当前路由规则是否允许创建、切换、归档、导出等操作。 |
| 416 | 当前路由固定了会话配置 | 检查固定模型、预设或聊天模式规则，必要时先重置规则。 |
| 417 | 聊天模式不存在 | 检查可用聊天模式，或确认相关扩展插件已启用。 |
| 418 | 会话归档不存在 | 确认该会话已经归档，或检查归档文件是否被删除。 |
| 419 | 归档和会话不匹配 | 不要手动混用归档文件；请重新归档或恢复正确会话。 |
| 420 | 会话恢复失败 | 检查数据库和归档文件是否完整，必要时提供日志反馈。 |
| 421 | 会话模型平台不可用 | 检查会话使用的模型适配器是否启用，API 配置是否可用。 |
| 422 | 会话模型名称无效 | 检查会话记录里的模型名称格式，应为 平台/模型名。 |
| 500 | 知识库配置错误 | 检查你的知识库配置文件。 |
| 501 | 知识库未找到文档 | 检查报错 log，检查知识库配置里引用的文档是否存在。 |
| 502 | 知识库配置文件循环引用 | 检查你的知识库配置语法文件。 |
| 503 | 不支持上传到知识库的文件类型 | 检查你上传的文件类型是否支持，或者切换到其他支持的文件类型。 |
| 504 | 知识库上传的文件已存在 | 如需继续上传可以尝试强制上传或者先删除原文件后再上传。 |
| 505 | 知识库对应的向量数据库未找到 | 检查配置里引用的向量数据库是否存在。 |
| 600 | 授权用户未找到 | 直接问开发者。 |
| 601 | 配额组未找到 | 切换到其他配额组，或询问开发者。 |
| 602 | 配额组未加入 | 加入该配额组，或询问开发者。 |
| 603 | 配额组已经加入了 | 都加入了当前配额组，就别在重复加入了。 |
| 999 | 未知错误 | 附上 log 直接反馈给开发者。 |
