现象
使用FastGPT私有部署v4.5.0版本时,会出现两类异常返回:第一类为模型调用错误,返回内容为{"code":500,"statusText":"","message":"当前分组 default 下对于模型 M3E 无可用渠道 (request id: 2023102316560920779259FmI5pN9a)","data":null};第二类为错误响应格式不符合预期,当API密钥无效时,FastGPT返回的格式与用户提供的示例错误格式不一致,用户期望调整为该示例的响应格式,示例格式为{"error":{"message":"Incorrect API key provided: xxx-*********************************************43ca. You can find your API key at https://platform.openai.com/account/api-keys.","type":"invalid_request_error","param":null,"code":"invalid_api_key"}}。
可能原因
- 系统配置的default分组中未添加M3E模型的可用渠道,导致调用该模型时触发无可用渠道的错误。
- FastGPT当前的错误响应逻辑未采用用户期望的标准格式,与提供的示例错误格式存在差异。
- 若出现API密钥无效的报错,可能是配置的密钥错误、密钥已过期或权限不足。
排查步骤
- 登录FastGPT私有部署的后台管理页面,进入分组管理模块,查看default分组下的模型配置列表,确认M3E模型是否已配置可用渠道。
- 检查当前使用的API密钥,确认密钥未过期、权限配置符合系统要求,排查密钥无效的问题。
- 记录错误返回中的request id,通过该id在系统日志中查询详细的错误链路,定位具体的触发点。
- 对比用户提供的示例错误格式,确认当前FastGPT返回的错误格式是否符合预期。
解决与验证
针对模型无可用渠道的问题:在分组管理的default分组中,找到M3E模型的配置项,添加对应的可用渠道并保存配置,重新调用模型即可恢复正常。针对错误响应格式的调整问题:修改系统的错误响应逻辑,将非预期的错误返回格式调整为与提供的示例错误格式一致。验证时,触发对应错误场景,检查返回的错误格式是否符合预期;完成M3E模型渠道配置后,重新调用模型,确认可以正常使用该模型。