mirror of
https://github.com/foxhui/WebAI2API.git
synced 2026-06-16 21:03:59 +08:00
foxhui
113 lines
3.1 KiB
JavaScript
113 lines
3.1 KiB
JavaScript
/**
|
||
* @fileoverview 错误码表与中文消息映射模块
|
||
* @description 统一定义服务器错误码及其对应的中文消息和 HTTP 状态码
|
||
*/
|
||
|
||
/**
|
||
* 错误码枚举
|
||
* @readonly
|
||
* @enum {string}
|
||
*/
|
||
export const ERROR_CODES = {
|
||
/** 未授权（Token 无效或缺失） */
|
||
UNAUTHORIZED: 'UNAUTHORIZED',
|
||
/** 浏览器未初始化 */
|
||
BROWSER_NOT_INITIALIZED: 'BROWSER_NOT_INITIALIZED',
|
||
/** 服务器繁忙（队列已满） */
|
||
SERVER_BUSY: 'SERVER_BUSY',
|
||
/** 请求参数缺少 messages */
|
||
NO_MESSAGES: 'NO_MESSAGES',
|
||
/** messages 中缺少 role=user 的消息 */
|
||
NO_USER_MESSAGES: 'NO_USER_MESSAGES',
|
||
/** 图片数量超过限制 */
|
||
TOO_MANY_IMAGES: 'TOO_MANY_IMAGES',
|
||
/** 模型无效/后端不支持 */
|
||
INVALID_MODEL: 'INVALID_MODEL',
|
||
/** 该模型需要参考图 */
|
||
IMAGE_REQUIRED: 'IMAGE_REQUIRED',
|
||
/** 该模型不支持图片输入 */
|
||
IMAGE_FORBIDDEN: 'IMAGE_FORBIDDEN',
|
||
/** 触发人机验证（reCAPTCHA） */
|
||
RECAPTCHA: 'RECAPTCHA',
|
||
/** 服务器内部错误 */
|
||
INTERNAL_ERROR: 'INTERNAL_ERROR',
|
||
};
|
||
|
||
/**
|
||
* 错误详情映射表
|
||
* @type {Record<string, {message: string, status: number}>}
|
||
*/
|
||
const ERROR_DETAILS = {
|
||
[ERROR_CODES.UNAUTHORIZED]: {
|
||
message: '未授权（Token 无效或缺失）',
|
||
status: 401,
|
||
},
|
||
[ERROR_CODES.BROWSER_NOT_INITIALIZED]: {
|
||
message: '浏览器未初始化',
|
||
status: 503,
|
||
},
|
||
[ERROR_CODES.SERVER_BUSY]: {
|
||
message: '服务器繁忙（队列已满）',
|
||
status: 429,
|
||
},
|
||
[ERROR_CODES.NO_MESSAGES]: {
|
||
message: '请求参数缺少 messages',
|
||
status: 400,
|
||
},
|
||
[ERROR_CODES.NO_USER_MESSAGES]: {
|
||
message: 'messages 中缺少 role=user 的消息',
|
||
status: 400,
|
||
},
|
||
[ERROR_CODES.TOO_MANY_IMAGES]: {
|
||
message: '图片数量超过限制',
|
||
status: 400,
|
||
},
|
||
[ERROR_CODES.INVALID_MODEL]: {
|
||
message: '模型无效/后端不支持',
|
||
status: 400,
|
||
},
|
||
[ERROR_CODES.IMAGE_REQUIRED]: {
|
||
message: '该模型需要参考图',
|
||
status: 400,
|
||
},
|
||
[ERROR_CODES.IMAGE_FORBIDDEN]: {
|
||
message: '该模型不支持图片输入',
|
||
status: 400,
|
||
},
|
||
[ERROR_CODES.RECAPTCHA]: {
|
||
message: '触发人机验证（reCAPTCHA）',
|
||
status: 500,
|
||
},
|
||
[ERROR_CODES.INTERNAL_ERROR]: {
|
||
message: '服务器内部错误',
|
||
status: 500,
|
||
},
|
||
};
|
||
|
||
/**
|
||
* 获取错误消息
|
||
* @param {string} code - 错误码
|
||
* @returns {string} 中文错误消息
|
||
*/
|
||
export function getErrorMessage(code) {
|
||
return ERROR_DETAILS[code]?.message || '未知错误';
|
||
}
|
||
|
||
/**
|
||
* 获取错误对应的 HTTP 状态码
|
||
* @param {string} code - 错误码
|
||
* @returns {number} HTTP 状态码
|
||
*/
|
||
export function getErrorStatus(code) {
|
||
return ERROR_DETAILS[code]?.status || 500;
|
||
}
|
||
|
||
/**
|
||
* 获取完整的错误详情
|
||
* @param {string} code - 错误码
|
||
* @returns {{message: string, status: number}} 错误详情
|
||
*/
|
||
export function getErrorDetails(code) {
|
||
return ERROR_DETAILS[code] || { message: '未知错误', status: 500 };
|
||
}
|