feat(service): ✨ http错误提示

src/common/exception.ts

@@ -1,6 +1,43 @@
+export enum ErrorType {
+  Network = 'NETWORK_ERROR',
+  Authentication = 'AUTH_ERROR',
+  Validation = 'VALIDATION_ERROR',
+  Server = 'SERVER_ERROR',
+  Client = 'CLIENT_ERROR',
+  Unknown = 'UNKNOWN_ERROR'
+}
+
+export interface ErrorDetails {
+  type: ErrorType
+  code?: number
+  details?: Record<string, any>
+}
+
 export class AppException extends Error {
-  constructor(message: string) {
+  public readonly type: ErrorType
+  public readonly code?: number
+  public readonly details?: Record<string, any>
+
+  constructor(message: string, errorDetails?: Partial<ErrorDetails>) {
     super(message)
     this.name = 'AppException'
+    this.type = errorDetails?.type || ErrorType.Unknown
+    this.code = errorDetails?.code
+    this.details = errorDetails?.details
+
+    // Show error message to user if window.$message is available
+    if (window.$message) {
+      window.$message.error(message)
+    }
+  }
+
+  public toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      type: this.type,
+      code: this.code,
+      details: this.details
+    }
   }
 }

src/services/http.ts

@@ -1,4 +1,5 @@
 import { fetch } from '@tauri-apps/plugin-http'
+import { AppException, ErrorType } from '../common/exception'
 
 /**
  * @description 请求参数
@@ -32,10 +33,12 @@
  */
 class FetchRetryError extends Error {
   status: number
+  type: ErrorType
   constructor(message: string, status: number) {
     super(message)
     this.status = status
     this.name = 'FetchRetryError'
+    this.type = status >= 500 ? ErrorType.Server : ErrorType.Network
   }
 }
 
@@ -144,33 +147,55 @@
 
       // 若响应不 OK 并且状态码属于需重试列表，则抛出 FetchRetryError
       if (!response.ok) {
+        const errorType = getErrorType(response.status)
         if (!retryOn || retryOn.includes(response.status)) {
           throw new FetchRetryError(`HTTP error! status: ${response.status}`, response.status)
         }
-        // 如果是非重试状态码，则抛出普通错误
-        throw new Error(`HTTP error! status: ${response.status}`)
+        // 如果是非重试状态码，则抛出带有适当错误类型的 AppException
+        throw new AppException(`HTTP error! status: ${response.status}`, {
+          type: errorType,
+          code: response.status,
+          details: { url, method: options.method }
+        })
       }
 
       // 解析响应数据
       const responseData = options.isBlob ? await response.arrayBuffer() : await response.json()
 
       // 若有success === false，需要重试
       if (responseData && responseData.success === false) {
-        throw new Error(url)
+        throw new AppException(responseData.message || url, {
+          type: ErrorType.Server,
+          code: response.status,
+          details: responseData
+        })
       }
 
       // 若请求成功且没有业务错误
       if (fullResponse) {
         return { data: responseData, resp: response }
       }
       return responseData
-    } catch (err) {
-      console.error(`Attempt ${currentAttempt + 1} failed →`, err)
+    } catch (error) {
+      console.error(`Attempt ${currentAttempt + 1} failed →`, error)
 
       // 检查是否仍需重试
       if (!shouldRetry(currentAttempt, retries, abort)) {
         console.error(`Max retries reached or aborted. Request failed → ${url}`)
-        throw err instanceof Error ? err : new Error(String(err)) // 不再重试，抛出最终错误
+        if (error instanceof FetchRetryError) {
+          throw new AppException(error.message, {
+            type: error.type,
+            code: error.status,
+            details: { url, attempts: currentAttempt + 1 }
+          })
+        }
+        if (error instanceof AppException) {
+          throw error
+        }
+        throw new AppException(String(error), {
+          type: ErrorType.Unknown,
+          details: { url, attempts: currentAttempt + 1 }
+        })
       }
 
       // 若需继续重试
@@ -181,6 +206,15 @@
     }
   }
 
+  // 辅助函数：根据HTTP状态码确定错误类型
+  function getErrorType(status: number): ErrorType {
+    if (status >= 500) return ErrorType.Server
+    if (status === 401 || status === 403) return ErrorType.Authentication
+    if (status === 400 || status === 422) return ErrorType.Validation
+    if (status >= 400) return ErrorType.Client
+    return ErrorType.Network
+  }
+
   // 第一次执行，attempt=0
   return attemptFetch(0)
 }