From 70a35204b35845425db65170134581e8fc45df85 Mon Sep 17 00:00:00 2001
From: yml2213 <a2213290201@gmail.com>
Date: Wed, 10 Jun 2026 15:52:49 +0800
Subject: [PATCH] =?UTF-8?q?=E7=BB=9F=E4=B8=80=E5=89=8D=E7=AB=AF=E9=94=99?=
 =?UTF-8?q?=E8=AF=AF=E8=AF=BB=E5=8F=96=E5=92=8C=E8=B0=83=E8=AF=95=E6=97=A5?=
 =?UTF-8?q?=E5=BF=97?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../admin/components/AdminUserDialog.vue      |  8 +----
 .../admin/components/AnnouncementDialog.vue   |  3 +-
 .../components/AssignPermissionsDialog.vue    |  8 +----
 .../admin/components/AssignRolesDialog.vue    |  8 +----
 .../admin/components/GeneralConfigDialog.vue  |  8 +----
 .../components/HomeAnnouncementsDialog.vue    |  8 +----
 .../admin/components/HomeBannersDialog.vue    |  8 +----
 .../ListingPublishAgreementsDialog.vue        |  8 +----
 .../components/OrderAgreementsDialog.vue      |  8 +----
 .../components/PostRentalNoticeDialog.vue     |  8 +----
 .../admin/components/PublishOptionsDialog.vue |  8 +----
 .../features/admin/components/RoleDialog.vue  |  8 +----
 .../admin/components/SalePriceDialog.vue      |  8 +----
 .../admin/composables/useAdminTable.ts        |  3 +-
 .../admin/views/AdminDisputesView.vue         |  8 +----
 .../admin/views/AdminListingDetailView.vue    |  8 +----
 .../admin/views/AdminListingReviewView.vue    |  8 +----
 .../features/admin/views/AdminLoginView.vue   |  8 +----
 .../admin/views/AdminMgrUsersView.vue         |  8 +----
 .../admin/views/AdminOrderDetailView.vue      |  8 +----
 .../features/admin/views/AdminUsersView.vue   |  8 +----
 .../views/AnnouncementDetailView.vue          |  3 +-
 .../announcement/views/AnnouncementsView.vue  |  3 +-
 .../src/features/auth/views/LoginView.vue     |  8 +----
 .../features/auth/views/MobileProfileView.vue |  8 +----
 .../auth/views/PostRentalNoticeView.vue       |  3 +-
 .../src/features/auth/views/ProfileView.vue   |  8 +----
 .../src/features/auth/views/RealnameView.vue  |  8 +----
 .../composables/useDesktopNotification.ts     |  5 +--
 .../listings/views/ListingDetailView.vue      |  8 +----
 .../views/MobileListingDetailView.vue         |  8 +----
 .../orders/views/MobileOrdersView.vue         |  8 +----
 .../src/features/orders/views/OrdersView.vue  |  8 +----
 .../seller/composables/usePublishForm.ts      |  8 +----
 .../src/features/wallet/views/WalletView.vue  |  8 +----
 frontend/src/shared/api/client.ts             |  7 ++--
 frontend/src/shared/api/monitor.ts            | 29 ++++++++++------
 .../src/shared/composables/useSmsCountdown.ts |  8 +----
 frontend/src/shared/utils/debug.ts            | 34 +++++++++++++++++++
 frontend/src/shared/utils/error.ts            | 13 +++++--
 40 files changed, 110 insertions(+), 233 deletions(-)
 create mode 100644 frontend/src/shared/utils/debug.ts

diff --git a/frontend/src/features/admin/components/AdminUserDialog.vue b/frontend/src/features/admin/components/AdminUserDialog.vue
index 5b620e1..09af78d 100644
--- a/frontend/src/features/admin/components/AdminUserDialog.vue
+++ b/frontend/src/features/admin/components/AdminUserDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -79,13 +80,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/AnnouncementDialog.vue b/frontend/src/features/admin/components/AnnouncementDialog.vue
index d7339de..6f85e6d 100644
--- a/frontend/src/features/admin/components/AnnouncementDialog.vue
+++ b/frontend/src/features/admin/components/AnnouncementDialog.vue
@@ -7,6 +7,7 @@ import type {
   CreateAnnouncementRequest,
   UpdateAnnouncementRequest,
 } from '@/features/admin/api/adminAnnouncements'
+import { debugError } from '@/shared/utils/debug'
 
 interface Props {
   visible: boolean
@@ -89,7 +90,7 @@ async function handleSave() {
     await formRef.value.validate()
     emit('save', formData.value)
   } catch (error) {
-    console.error('表单验证失败', error)
+    debugError('表单验证失败', error)
   }
 }
 </script>
diff --git a/frontend/src/features/admin/components/AssignPermissionsDialog.vue b/frontend/src/features/admin/components/AssignPermissionsDialog.vue
index 2a0a70d..c5b44ee 100644
--- a/frontend/src/features/admin/components/AssignPermissionsDialog.vue
+++ b/frontend/src/features/admin/components/AssignPermissionsDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -94,13 +95,6 @@ function isGroupPartial(perms: Permission[]) {
   return perms.some(p => selectedPermIds.value.includes(p.id)) && !isGroupAllSelected(perms)
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 const resourceLabels: Record<string, string> = {
   dashboard: '仪表盘',
diff --git a/frontend/src/features/admin/components/AssignRolesDialog.vue b/frontend/src/features/admin/components/AssignRolesDialog.vue
index 0545c40..af34476 100644
--- a/frontend/src/features/admin/components/AssignRolesDialog.vue
+++ b/frontend/src/features/admin/components/AssignRolesDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -52,13 +53,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/GeneralConfigDialog.vue b/frontend/src/features/admin/components/GeneralConfigDialog.vue
index c771934..e92a780 100644
--- a/frontend/src/features/admin/components/GeneralConfigDialog.vue
+++ b/frontend/src/features/admin/components/GeneralConfigDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { computed, ref, watch } from 'vue'
 
@@ -64,13 +65,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/HomeAnnouncementsDialog.vue b/frontend/src/features/admin/components/HomeAnnouncementsDialog.vue
index db4a072..cd7e1fd 100644
--- a/frontend/src/features/admin/components/HomeAnnouncementsDialog.vue
+++ b/frontend/src/features/admin/components/HomeAnnouncementsDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -69,13 +70,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/HomeBannersDialog.vue b/frontend/src/features/admin/components/HomeBannersDialog.vue
index 7edef41..a0114e3 100644
--- a/frontend/src/features/admin/components/HomeBannersDialog.vue
+++ b/frontend/src/features/admin/components/HomeBannersDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -110,13 +111,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/ListingPublishAgreementsDialog.vue b/frontend/src/features/admin/components/ListingPublishAgreementsDialog.vue
index 891d07f..23fdc3e 100644
--- a/frontend/src/features/admin/components/ListingPublishAgreementsDialog.vue
+++ b/frontend/src/features/admin/components/ListingPublishAgreementsDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -127,13 +128,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/OrderAgreementsDialog.vue b/frontend/src/features/admin/components/OrderAgreementsDialog.vue
index 59b774b..9086630 100644
--- a/frontend/src/features/admin/components/OrderAgreementsDialog.vue
+++ b/frontend/src/features/admin/components/OrderAgreementsDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -128,13 +129,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/PostRentalNoticeDialog.vue b/frontend/src/features/admin/components/PostRentalNoticeDialog.vue
index 44e1463..b3643ca 100644
--- a/frontend/src/features/admin/components/PostRentalNoticeDialog.vue
+++ b/frontend/src/features/admin/components/PostRentalNoticeDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -110,13 +111,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/PublishOptionsDialog.vue b/frontend/src/features/admin/components/PublishOptionsDialog.vue
index 08b6905..9adbe40 100644
--- a/frontend/src/features/admin/components/PublishOptionsDialog.vue
+++ b/frontend/src/features/admin/components/PublishOptionsDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -183,13 +184,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/RoleDialog.vue b/frontend/src/features/admin/components/RoleDialog.vue
index 1c316a6..1428db2 100644
--- a/frontend/src/features/admin/components/RoleDialog.vue
+++ b/frontend/src/features/admin/components/RoleDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -77,13 +78,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/components/SalePriceDialog.vue b/frontend/src/features/admin/components/SalePriceDialog.vue
index 501336d..f8fe8f4 100644
--- a/frontend/src/features/admin/components/SalePriceDialog.vue
+++ b/frontend/src/features/admin/components/SalePriceDialog.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref, watch } from 'vue'
 
@@ -88,13 +89,6 @@ async function handleSave() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/composables/useAdminTable.ts b/frontend/src/features/admin/composables/useAdminTable.ts
index 6bc80e3..78240d2 100644
--- a/frontend/src/features/admin/composables/useAdminTable.ts
+++ b/frontend/src/features/admin/composables/useAdminTable.ts
@@ -1,4 +1,5 @@
 import { ref, type Ref } from 'vue'
+import { debugError } from '@/shared/utils/debug'
 
 interface AdminQueryOptions<T> {
   fetchFn: () => Promise<T>
@@ -25,7 +26,7 @@ export function useAdminQuery<T>(options: AdminQueryOptions<T>): AdminQueryResul
       data.value = await options.fetchFn()
     } catch (e) {
       error.value = e instanceof Error ? e.message : '加载失败'
-      console.error('Failed to load data:', e)
+      debugError('加载后台表格数据失败', e)
     } finally {
       loading.value = false
     }
diff --git a/frontend/src/features/admin/views/AdminDisputesView.vue b/frontend/src/features/admin/views/AdminDisputesView.vue
index 2036e0f..0f8d3a3 100644
--- a/frontend/src/features/admin/views/AdminDisputesView.vue
+++ b/frontend/src/features/admin/views/AdminDisputesView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { computed, onMounted, ref } from 'vue'
 
@@ -114,13 +115,6 @@ async function handleArbitrate() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/views/AdminListingDetailView.vue b/frontend/src/features/admin/views/AdminListingDetailView.vue
index faa3c47..9d4828c 100644
--- a/frontend/src/features/admin/views/AdminListingDetailView.vue
+++ b/frontend/src/features/admin/views/AdminListingDetailView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { CopyDocument } from '@element-plus/icons-vue'
 import { ElMessage } from 'element-plus'
 import { computed, onMounted, ref } from 'vue'
@@ -104,13 +105,6 @@ async function openScreenshot(url: string) {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/views/AdminListingReviewView.vue b/frontend/src/features/admin/views/AdminListingReviewView.vue
index 2172e51..c0f59d5 100644
--- a/frontend/src/features/admin/views/AdminListingReviewView.vue
+++ b/frontend/src/features/admin/views/AdminListingReviewView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { Check, Close, Picture, Refresh, Search, WarningFilled } from '@element-plus/icons-vue'
 import { ElMessage, ElMessageBox } from 'element-plus'
 import { computed, nextTick, onBeforeUnmount, onMounted, reactive, ref, watch } from 'vue'
@@ -548,13 +549,6 @@ async function openScreenshot(url: string) {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/views/AdminLoginView.vue b/frontend/src/features/admin/views/AdminLoginView.vue
index 4d5bb2f..206a80e 100644
--- a/frontend/src/features/admin/views/AdminLoginView.vue
+++ b/frontend/src/features/admin/views/AdminLoginView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { Lock, User } from '@element-plus/icons-vue'
 import { onMounted, reactive, ref } from 'vue'
@@ -51,13 +52,6 @@ async function handleLogin() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/admin/views/AdminMgrUsersView.vue b/frontend/src/features/admin/views/AdminMgrUsersView.vue
index 1affbc8..5ae9030 100644
--- a/frontend/src/features/admin/views/AdminMgrUsersView.vue
+++ b/frontend/src/features/admin/views/AdminMgrUsersView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage, ElMessageBox } from 'element-plus'
 import { ref } from 'vue'
 
@@ -93,13 +94,6 @@ async function handleChangePassword() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 const statusLabel: Record<string, string> = {
   active: '启用',
diff --git a/frontend/src/features/admin/views/AdminOrderDetailView.vue b/frontend/src/features/admin/views/AdminOrderDetailView.vue
index 44fe751..85ed0e6 100644
--- a/frontend/src/features/admin/views/AdminOrderDetailView.vue
+++ b/frontend/src/features/admin/views/AdminOrderDetailView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { computed, onMounted, ref } from 'vue'
 import { useRoute } from 'vue-router'
@@ -87,13 +88,6 @@ async function submitAction() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 function orderRentedAt() {
   return order.value?.rented_at
diff --git a/frontend/src/features/admin/views/AdminUsersView.vue b/frontend/src/features/admin/views/AdminUsersView.vue
index a34f56d..1b2647b 100644
--- a/frontend/src/features/admin/views/AdminUsersView.vue
+++ b/frontend/src/features/admin/views/AdminUsersView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ref } from 'vue'
 
@@ -85,13 +86,6 @@ async function handleUnfreeze(row: AdminUserItem) {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 function moneyCent(value: number | string | undefined) {
   return formatCent(Number(value || 0))
diff --git a/frontend/src/features/announcement/views/AnnouncementDetailView.vue b/frontend/src/features/announcement/views/AnnouncementDetailView.vue
index ed799fc..8551860 100644
--- a/frontend/src/features/announcement/views/AnnouncementDetailView.vue
+++ b/frontend/src/features/announcement/views/AnnouncementDetailView.vue
@@ -11,6 +11,7 @@ import {
   Warning,
 } from '@element-plus/icons-vue'
 import { fetchAnnouncementDetail, type Announcement } from '@/features/announcement'
+import { debugError } from '@/shared/utils/debug'
 import { formatDateTime } from '@/shared/utils/time'
 import { marked } from 'marked'
 
@@ -51,7 +52,7 @@ async function loadAnnouncement() {
   try {
     announcement.value = await fetchAnnouncementDetail(id)
   } catch (err) {
-    console.error('加载公告失败', err)
+    debugError('加载公告失败', err)
     router.push('/announcements')
   } finally {
     loading.value = false
diff --git a/frontend/src/features/announcement/views/AnnouncementsView.vue b/frontend/src/features/announcement/views/AnnouncementsView.vue
index c768a75..eac9e91 100644
--- a/frontend/src/features/announcement/views/AnnouncementsView.vue
+++ b/frontend/src/features/announcement/views/AnnouncementsView.vue
@@ -10,6 +10,7 @@ import {
   Warning,
 } from '@element-plus/icons-vue'
 import { fetchAnnouncements, type Announcement } from '@/features/announcement'
+import { debugError } from '@/shared/utils/debug'
 import { formatDateTime } from '@/shared/utils/time'
 
 const router = useRouter()
@@ -43,7 +44,7 @@ async function loadAnnouncements() {
     announcements.value = result.items
     total.value = result.total
   } catch (err) {
-    console.error('加载公告失败', err)
+    debugError('加载公告失败', err)
   } finally {
     loading.value = false
   }
diff --git a/frontend/src/features/auth/views/LoginView.vue b/frontend/src/features/auth/views/LoginView.vue
index fd3d60a..671b2ab 100644
--- a/frontend/src/features/auth/views/LoginView.vue
+++ b/frontend/src/features/auth/views/LoginView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage } from 'element-plus'
 import { ChatLineRound, Iphone } from '@element-plus/icons-vue'
 import { onUnmounted, reactive, ref } from 'vue'
@@ -67,13 +68,6 @@ async function handleLogin() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/auth/views/MobileProfileView.vue b/frontend/src/features/auth/views/MobileProfileView.vue
index 54a6395..06304c7 100644
--- a/frontend/src/features/auth/views/MobileProfileView.vue
+++ b/frontend/src/features/auth/views/MobileProfileView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { computed, onMounted, reactive, ref } from 'vue'
 import { useRouter, useRoute } from 'vue-router'
 import { useSessionStore } from '@/stores/session'
@@ -208,13 +209,6 @@ async function saveProfile() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 function confirmLogout() {
   showSettings.value = false
diff --git a/frontend/src/features/auth/views/PostRentalNoticeView.vue b/frontend/src/features/auth/views/PostRentalNoticeView.vue
index 8cd2481..5e4f8ba 100644
--- a/frontend/src/features/auth/views/PostRentalNoticeView.vue
+++ b/frontend/src/features/auth/views/PostRentalNoticeView.vue
@@ -4,6 +4,7 @@ import { onMounted, ref } from 'vue'
 import { useRouter } from 'vue-router'
 
 import { fetchPostRentalNotice, type PostRentalNotice } from '@/features/orders/api/orders'
+import { debugError } from '@/shared/utils/debug'
 import { useSessionStore } from '@/stores/session'
 
 const session = useSessionStore()
@@ -24,7 +25,7 @@ async function loadNotice() {
   try {
     notice.value = await fetchPostRentalNotice()
   } catch (error) {
-    console.error('Failed to load post rental notice:', error)
+    debugError('加载租后须知失败', error)
   } finally {
     loading.value = false
   }
diff --git a/frontend/src/features/auth/views/ProfileView.vue b/frontend/src/features/auth/views/ProfileView.vue
index 5f633c4..c9e7aff 100644
--- a/frontend/src/features/auth/views/ProfileView.vue
+++ b/frontend/src/features/auth/views/ProfileView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import {
   Camera,
   CircleCheckFilled,
@@ -145,13 +146,6 @@ async function saveProfile() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/auth/views/RealnameView.vue b/frontend/src/features/auth/views/RealnameView.vue
index f146c63..a204420 100644
--- a/frontend/src/features/auth/views/RealnameView.vue
+++ b/frontend/src/features/auth/views/RealnameView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import {
   CircleCheckFilled,
   CreditCard,
@@ -108,13 +109,6 @@ async function handleSubmit() {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 </script>
 
 <template>
diff --git a/frontend/src/features/chats/composables/useDesktopNotification.ts b/frontend/src/features/chats/composables/useDesktopNotification.ts
index 1f2a1fb..43ee033 100644
--- a/frontend/src/features/chats/composables/useDesktopNotification.ts
+++ b/frontend/src/features/chats/composables/useDesktopNotification.ts
@@ -1,6 +1,7 @@
 import { ref } from 'vue'
 import { useRouter } from 'vue-router'
 import type { ChatEvent } from './useChatSSE'
+import { debugError } from '@/shared/utils/debug'
 
 export type NotificationPermission = 'default' | 'granted' | 'denied'
 
@@ -119,7 +120,7 @@ export function useDesktopNotification(scope: 'user' | 'admin') {
           notification.close()
         }, 5000)
       } catch (error) {
-        console.error('Failed to show notification:', error)
+        debugError('桌面通知发送失败', error)
       }
     }
 
@@ -205,6 +206,6 @@ function speakText(text: string) {
     utterance.volume = 1
     window.speechSynthesis.speak(utterance)
   } catch (error) {
-    console.error('Failed to speak notification:', error)
+    debugError('语音提醒播放失败', error)
   }
 }
diff --git a/frontend/src/features/listings/views/ListingDetailView.vue b/frontend/src/features/listings/views/ListingDetailView.vue
index a6bcfcb..f2d8d33 100644
--- a/frontend/src/features/listings/views/ListingDetailView.vue
+++ b/frontend/src/features/listings/views/ListingDetailView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { ElMessage, ElMessageBox } from 'element-plus'
 import { computed, nextTick, onMounted, ref, watch } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
@@ -274,13 +275,6 @@ function updateAgreementReadState(type: 'virtual' | 'renter') {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 // 手动锁定/解锁背景滚动
 watch(agreementVisible, visible => {
diff --git a/frontend/src/features/listings/views/MobileListingDetailView.vue b/frontend/src/features/listings/views/MobileListingDetailView.vue
index 744b587..d18adae 100644
--- a/frontend/src/features/listings/views/MobileListingDetailView.vue
+++ b/frontend/src/features/listings/views/MobileListingDetailView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { computed, nextTick, onMounted, ref } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
 import { showToast, showDialog } from 'vant'
@@ -255,13 +256,6 @@ function updateAgreementReadState(type: 'virtual' | 'renter') {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 async function copyListingCode() {
   if (!listing.value) return
diff --git a/frontend/src/features/orders/views/MobileOrdersView.vue b/frontend/src/features/orders/views/MobileOrdersView.vue
index 50a1a35..908d4cb 100644
--- a/frontend/src/features/orders/views/MobileOrdersView.vue
+++ b/frontend/src/features/orders/views/MobileOrdersView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { onMounted, ref, computed } from 'vue'
 import { useRouter, useRoute } from 'vue-router'
 import { showDialog, showToast } from 'vant'
@@ -111,13 +112,6 @@ function openPaymentCashier(payment: PaymentOrder) {
   })
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 function money(value: unknown) {
   return formatMoney(Number(value || 0))
diff --git a/frontend/src/features/orders/views/OrdersView.vue b/frontend/src/features/orders/views/OrdersView.vue
index 45e94e0..c2046eb 100644
--- a/frontend/src/features/orders/views/OrdersView.vue
+++ b/frontend/src/features/orders/views/OrdersView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { computed, onMounted, ref, watch } from 'vue'
 import { ElMessage } from 'element-plus'
 import { useRoute, useRouter } from 'vue-router'
@@ -101,13 +102,6 @@ async function handlePay(order: Order) {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 function orderRole(order: Order) {
   if (order.renter_id === session.userId) return '租客'
diff --git a/frontend/src/features/seller/composables/usePublishForm.ts b/frontend/src/features/seller/composables/usePublishForm.ts
index 18a14d2..85628bc 100644
--- a/frontend/src/features/seller/composables/usePublishForm.ts
+++ b/frontend/src/features/seller/composables/usePublishForm.ts
@@ -1,3 +1,4 @@
+import { readError } from '@/shared/utils/error'
 import { computed, onBeforeUnmount, onMounted, reactive, ref, watch } from 'vue'
 import { useRouter } from 'vue-router'
 
@@ -828,13 +829,6 @@ export function usePublishForm(options: UsePublishFormOptions) {
   }
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 function parseOnlineTime(value: string) {
   const match = /^(\d{2}):(\d{2})$/.exec(value)
diff --git a/frontend/src/features/wallet/views/WalletView.vue b/frontend/src/features/wallet/views/WalletView.vue
index 30ca7b2..6c2c89d 100644
--- a/frontend/src/features/wallet/views/WalletView.vue
+++ b/frontend/src/features/wallet/views/WalletView.vue
@@ -1,4 +1,5 @@
 <script setup lang="ts">
+import { readError } from '@/shared/utils/error'
 import { computed, onBeforeUnmount, onMounted, ref, watch } from 'vue'
 import { useRouter } from 'vue-router'
 import { ElMessage } from 'element-plus'
@@ -218,13 +219,6 @@ function openRechargePayURL() {
   window.open(payURL, '_blank', 'noopener,noreferrer')
 }
 
-function readError(error: unknown, fallback: string) {
-  if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
-  }
-  return fallback
-}
 
 function walletBizTypeLabel(type: string) {
   const map: Record<string, string> = {
diff --git a/frontend/src/shared/api/client.ts b/frontend/src/shared/api/client.ts
index 4da7051..66c21b6 100644
--- a/frontend/src/shared/api/client.ts
+++ b/frontend/src/shared/api/client.ts
@@ -2,6 +2,7 @@ import axios, { type AxiosResponse, type InternalAxiosRequestConfig, type AxiosE
 import { ElMessage } from 'element-plus'
 import { showToast } from 'vant'
 import { apiMonitor } from './monitor'
+import { debugError, debugLog } from '@/shared/utils/debug'
 
 function showError(message: string) {
   const isMobile = window.location.pathname.startsWith('/m')
@@ -24,7 +25,7 @@ declare module 'axios' {
 // 开发环境日志记录
 function logRequest(config: InternalAxiosRequestConfig) {
   if (import.meta.env.DEV) {
-    console.log(`[API Request] ${config.method?.toUpperCase()} ${config.url}`, {
+    debugLog(`[API Request] ${config.method?.toUpperCase()} ${config.url}`, {
       params: config.params,
       data: config.data,
       headers: config.headers,
@@ -38,7 +39,7 @@ function logRequest(config: InternalAxiosRequestConfig) {
 function logResponse(response: AxiosResponse) {
   if (import.meta.env.DEV) {
     const duration = response.config._startTime ? Date.now() - response.config._startTime : 0
-    console.log(
+    debugLog(
       `[API Response] ${response.config.method?.toUpperCase()} ${response.config.url} (${duration}ms)`,
       {
         status: response.status,
@@ -63,7 +64,7 @@ function logResponse(response: AxiosResponse) {
 function logError(error: AxiosError) {
   if (import.meta.env.DEV) {
     const duration = error.config?._startTime ? Date.now() - error.config._startTime : 0
-    console.error(
+    debugError(
       `[API Error] ${error.config?.method?.toUpperCase()} ${error.config?.url} (${duration}ms)`,
       {
         status: error.response?.status,
diff --git a/frontend/src/shared/api/monitor.ts b/frontend/src/shared/api/monitor.ts
index c1e8548..6827d75 100644
--- a/frontend/src/shared/api/monitor.ts
+++ b/frontend/src/shared/api/monitor.ts
@@ -2,6 +2,13 @@
  * API 性能监控
  * 记录和分析 API 请求性能
  */
+import {
+  debugGroup,
+  debugGroupEnd,
+  debugLog,
+  debugTable,
+  debugWarn,
+} from '@/shared/utils/debug'
 
 interface RequestMetrics {
   url: string
@@ -29,7 +36,7 @@ class ApiMonitor {
 
     // 开发环境下，慢请求警告
     if (import.meta.env.DEV && metric.duration > 1000) {
-      console.warn(`[API 慢请求] ${metric.method} ${metric.url} 耗时 ${metric.duration}ms`)
+      debugWarn(`[API 慢请求] ${metric.method} ${metric.url} 耗时 ${metric.duration}ms`)
     }
   }
 
@@ -105,12 +112,12 @@ class ApiMonitor {
    * 打印性能报告
    */
   printReport() {
-    console.group('📊 API 性能报告')
-    console.log('总请求数:', this.metrics.length)
-    console.log('平均响应时间:', this.getAverageResponseTime(), 'ms')
-    console.log('成功率:', this.getSuccessRate(), '%')
-    console.log('最慢的 5 个请求:')
-    console.table(
+    debugGroup('API 性能报告')
+    debugLog('总请求数:', this.metrics.length)
+    debugLog('平均响应时间:', this.getAverageResponseTime(), 'ms')
+    debugLog('成功率:', this.getSuccessRate(), '%')
+    debugLog('最慢的 5 个请求:')
+    debugTable(
       this.getSlowestRequests(5).map(m => ({
         方法: m.method,
         URL: m.url,
@@ -118,9 +125,9 @@ class ApiMonitor {
         状态: m.status,
       }))
     )
-    console.log('按 URL 统计:')
-    console.table(this.getStatsByUrl())
-    console.groupEnd()
+    debugLog('按 URL 统计:')
+    debugTable(this.getStatsByUrl())
+    debugGroupEnd()
   }
 }
 
@@ -130,5 +137,5 @@ export const apiMonitor = new ApiMonitor()
 // 开发环境下暴露到 window 对象，方便调试
 if (import.meta.env.DEV) {
   ;(window as any).__apiMonitor = apiMonitor
-  console.log('💡 使用 __apiMonitor.printReport() 查看 API 性能报告')
+  debugLog('使用 __apiMonitor.printReport() 查看 API 性能报告')
 }
diff --git a/frontend/src/shared/composables/useSmsCountdown.ts b/frontend/src/shared/composables/useSmsCountdown.ts
index 1512266..32251e1 100644
--- a/frontend/src/shared/composables/useSmsCountdown.ts
+++ b/frontend/src/shared/composables/useSmsCountdown.ts
@@ -1,3 +1,4 @@
+import { readError } from '@/shared/utils/error'
 import { onUnmounted, ref } from 'vue'
 import { showToast } from 'vant'
 import { sendSmsCode } from '@/features/auth/api/auth'
@@ -51,13 +52,6 @@ export function useSmsCountdown() {
     }
   }
 
-  function readError(error: unknown, fallback: string) {
-    if (typeof error === 'object' && error && 'response' in error) {
-      const response = (error as { response?: { data?: { message?: string } } }).response
-      return response?.data?.message || fallback
-    }
-    return fallback
-  }
 
   return {
     countDown,
diff --git a/frontend/src/shared/utils/debug.ts b/frontend/src/shared/utils/debug.ts
new file mode 100644
index 0000000..f5a0f0f
--- /dev/null
+++ b/frontend/src/shared/utils/debug.ts
@@ -0,0 +1,34 @@
+type DebugConsole = Pick<
+  Console,
+  'log' | 'warn' | 'error' | 'group' | 'groupEnd' | 'table'
+>
+
+function runInDev(method: keyof DebugConsole, args: unknown[]) {
+  if (!import.meta.env.DEV) return
+  console[method](...args)
+}
+
+export function debugLog(...args: unknown[]) {
+  runInDev('log', args)
+}
+
+export function debugWarn(...args: unknown[]) {
+  runInDev('warn', args)
+}
+
+export function debugError(...args: unknown[]) {
+  runInDev('error', args)
+}
+
+export function debugGroup(...args: unknown[]) {
+  runInDev('group', args)
+}
+
+export function debugGroupEnd() {
+  runInDev('groupEnd', [])
+}
+
+export function debugTable(data?: unknown, columns?: string[]) {
+  if (!import.meta.env.DEV) return
+  console.table(data, columns)
+}
diff --git a/frontend/src/shared/utils/error.ts b/frontend/src/shared/utils/error.ts
index ce33ab1..916e02f 100644
--- a/frontend/src/shared/utils/error.ts
+++ b/frontend/src/shared/utils/error.ts
@@ -3,8 +3,17 @@
  */
 export function readError(error: unknown, fallback: string): string {
   if (typeof error === 'object' && error && 'response' in error) {
-    const response = (error as { response?: { data?: { message?: string } } }).response
-    return response?.data?.message || fallback
+    const response = (
+      error as {
+        response?: {
+          data?: {
+            message?: string
+            error?: string
+          }
+        }
+      }
+    ).response
+    return response?.data?.message || response?.data?.error || fallback
   }
   if (error instanceof Error) {
     return error.message || fallback