防抖加锁

shop-app/components/goods/DetailBottomBar.vue

@@ -5,8 +5,8 @@
 			<text class="bottom-bar__shop-text">店铺</text>
 		</view>
 		<view class="bottom-bar__actions">
-			<button class="btn btn-cart" :disabled="disabled" @click="emit('cart')">加入购物车</button>
-			<button class="btn btn-buy" :disabled="disabled" @click="emit('buy')">立即购买</button>
+			<button class="btn btn-cart" :disabled="disabled || busy" @click="emit('cart')">加入购物车</button>
+			<button class="btn btn-buy" :disabled="disabled || busy" @click="emit('buy')">立即购买</button>
 		</view>
 	</view>
 </template>
@@ -16,6 +16,11 @@ defineProps({
 	disabled: {
 		type: Boolean,
 		default: false
+	},
+	/** 提交中：防抖加锁，禁止重复点击 */
+	busy: {
+		type: Boolean,
+		default: false
 	}
 })
 const emit = defineEmits(['cart', 'buy', 'shop'])

shop-app/pages/cart/index.vue

@@ -53,7 +53,7 @@
 					</view>
 					<button
 						class="cart-footer__btn"
-						:disabled="!checkedSummary.checkedCount"
+						:disabled="!checkedSummary.checkedCount || actionLock"
 						@click="onCheckout"
 					>
 						去结算({{ checkedSummary.checkedCount }})
@@ -89,8 +89,11 @@ import { CART_EMPTY_TEXT, CART_MSG_CROSS_SHOP } from '@/constants/cart'
 import { goGoodsDetail } from '@/utils/goodsDetail'
 import { goShopHome } from '@/utils/shopNav'
 import { PAGE_LOGIN, PAGE_HOME } from '@/utils/pageRoute'
+import { useActionGuard } from '@/utils/actionGuard'
 import CartShopGroup from '@/components/cart/CartShopGroup.vue'
 
+const { locked: actionLock, run: runCartAction } = useActionGuard()
+
 const loggedIn = ref(false)
 const loading = ref(false)
 const loadFailed = ref(false)
@@ -102,7 +105,6 @@ const checkedSummary = ref({
 })
 const scrollHeight = ref('500px')
 const emptyText = CART_EMPTY_TEXT
-const actionLock = ref(false)
 
 const showInvalidBar = computed(() => hasInvalidCartItems(groups.value))
 
@@ -157,16 +159,15 @@ function buildCheckedPayload(items) {
 }
 
 async function syncChecked(items) {
-	if (!items.length || actionLock.value) return
-	actionLock.value = true
-	try {
-		await updateCartChecked(buildCheckedPayload(items))
-		await loadCart()
-	} catch (e) {
-		await loadCart()
-	} finally {
-		actionLock.value = false
-	}
+	if (!items.length) return
+	runCartAction(async () => {
+		try {
+			await updateCartChecked(buildCheckedPayload(items))
+			await loadCart()
+		} catch (e) {
+			await loadCart()
+		}
+	})
 }
 
 function onItemCheck(item, checked) {
@@ -188,17 +189,15 @@ function onToggleSelectAll() {
 	syncChecked(items)
 }
 
-async function onQuantityChange(item, quantity) {
-	if (actionLock.value) return
-	actionLock.value = true
-	try {
-		await updateCartQuantity(item.cartItemId, quantity)
-		await loadCart()
-	} catch (e) {
-		await loadCart()
-	} finally {
-		actionLock.value = false
-	}
+function onQuantityChange(item, quantity) {
+	runCartAction(async () => {
+		try {
+			await updateCartQuantity(item.cartItemId, quantity)
+			await loadCart()
+		} catch (e) {
+			await loadCart()
+		}
+	})
 }
 
 function confirmRemove(onConfirm) {
@@ -268,23 +267,21 @@ async function onCleanInvalid() {
 	})
 }
 
-async function onCheckout() {
-	const ids = getCheckedPurchasableIds(groups.value)
-	if (!ids.length) {
-		uni.showToast({ title: '请先勾选要结算的商品', icon: 'none' })
-		return
-	}
-	const shopIds = getCheckedShopIds(groups.value)
-	if (shopIds.size > 1) {
-		uni.showToast({ title: CART_MSG_CROSS_SHOP, icon: 'none' })
-		return
-	}
-	try {
+function onCheckout() {
+	runCartAction(async () => {
+		const ids = getCheckedPurchasableIds(groups.value)
+		if (!ids.length) {
+			uni.showToast({ title: '请先勾选要结算的商品', icon: 'none' })
+			return
+		}
+		const shopIds = getCheckedShopIds(groups.value)
+		if (shopIds.size > 1) {
+			uni.showToast({ title: CART_MSG_CROSS_SHOP, icon: 'none' })
+			return
+		}
 		await prepareCartCheckout(ids)
 		goCartCheckout(ids)
-	} catch (e) {
-		// request 已提示
-	}
+	})
 }
 
 function onShopClick(group) {

shop-app/pages/login/index.vue

@@ -59,6 +59,7 @@
 
 				<view
 					:class="['auth-btn', { 'auth-btn--loading': loading }]"
+					:disabled="loading"
 					@click="handleLogin"
 				>
 					<text class="auth-btn__txt">{{ loading ? '登录中…' : '登 录' }}</text>
@@ -84,8 +85,10 @@ import { useUserStore } from '@/store/user'
 import { loadServiceAgreement } from '@/utils/memberAgreement'
 import { PAGE_HOME, PAGE_REGISTER } from '@/utils/pageRoute'
 import AgreementBlock from '@/components/account/AgreementBlock.vue'
+import { useActionGuard } from '@/utils/actionGuard'
 
-const loading = ref(false)
+const loginGuard = useActionGuard()
+const loading = loginGuard.locked
 const agreement = reactive({
   enabled: false,
   requireAgreementOnLogin: false,
@@ -154,30 +157,24 @@ function validateForm() {
 }
 
 function handleLogin() {
-  if (!validateForm() || loading.value) {
-    return
-  }
-  const account = form.account.trim()
-  if (form.rememberMe) {
-    uni.setStorageSync(REMEMBER_ACCOUNT_KEY, account)
-  } else {
-    uni.removeStorageSync(REMEMBER_ACCOUNT_KEY)
-  }
-  loading.value = true
-  const userStore = useUserStore()
-  userStore.fedLogOut()
-  userStore
-    .login({
+  loginGuard.run(async () => {
+    if (!validateForm()) return
+    const account = form.account.trim()
+    if (form.rememberMe) {
+      uni.setStorageSync(REMEMBER_ACCOUNT_KEY, account)
+    } else {
+      uni.removeStorageSync(REMEMBER_ACCOUNT_KEY)
+    }
+    const userStore = useUserStore()
+    userStore.fedLogOut()
+    await userStore.login({
       account,
       password: form.password,
       agreementAccepted: needAgreement.value ? form.agreementAccepted : true
     })
-    .then(() => userStore.fetchUserInfo())
-    .then(() => goHome())
-    .catch(() => {})
-    .finally(() => {
-      loading.value = false
-    })
+    await userStore.fetchUserInfo()
+    goHome()
+  })
 }
 </script>
 

shop-app/subpackage/account/address-edit.vue

@@ -45,10 +45,13 @@ import { ensureApiToken } from '@/utils/apiAuth'
 import { validateMobile } from '@/utils/memberValidate'
 import { loadRegionCascaderTree, findRegionPath } from '@/utils/region'
 import RegionFields from '@/components/mine/RegionFields.vue'
+import { useActionGuard } from '@/utils/actionGuard'
+
+const saveGuard = useActionGuard()
+const saving = saveGuard.locked
 
 const mode = ref('add')
 const addressId = ref(null)
-const saving = ref(false)
 
 const form = reactive({
   consigneeName: '',
@@ -139,18 +142,13 @@ function buildPayload() {
 }
 
 function handleSave() {
-  if (saving.value || !validate()) return
-  saving.value = true
-  const api = mode.value === 'edit' ? updateAddress : addAddress
-  api(buildPayload())
-    .then(() => {
-      uni.showToast({ title: '保存成功', icon: 'none' })
-      setTimeout(() => uni.navigateBack(), 600)
-    })
-    .catch(() => {})
-    .finally(() => {
-      saving.value = false
-    })
+  saveGuard.run(async () => {
+    if (!validate()) return
+    const api = mode.value === 'edit' ? updateAddress : addAddress
+    await api(buildPayload())
+    uni.showToast({ title: '保存成功', icon: 'none' })
+    setTimeout(() => uni.navigateBack(), 600)
+  })
 }
 </script>
 

shop-app/subpackage/account/entry-apply.vue

@@ -104,6 +104,10 @@ import EntryEnterpriseBiz from '@/components/mine/entry/EntryEnterpriseBiz.vue'
 import EntryShopFields from '@/components/mine/entry/EntryShopFields.vue'
 import { PAGE_ENTRY_LIST, PAGE_PROFILE } from '@/utils/pageRoute'
 import { useUserStore } from '@/store/user'
+import { useActionGuard } from '@/utils/actionGuard'
+
+const submitGuard = useActionGuard()
+const submitting = submitGuard.locked
 
 const form = reactive(createEntryForm(MERCHANT_TYPE_PERSON))
 const agreement = reactive({
@@ -116,7 +120,6 @@ const agreement = reactive({
 })
 
 const stepIndex = ref(0)
-const submitting = ref(false)
 const entryOpen = ref(true)
 const blocked = ref(false)
 const regionBiz = ref({ regionCode: '', regionName: '', pathCodes: [] })
@@ -228,18 +231,13 @@ function doSubmit() {
     content: '提交后不可修改，是否确认？',
     success: (res) => {
       if (!res.confirm) return
-      submitting.value = true
-      submitEntryApply(buildEntrySubmitPayload(form))
-        .then(() => {
-          uni.showToast({ title: '提交成功，请等待审核', icon: 'none', duration: 2500 })
-          setTimeout(() => {
-            uni.redirectTo({ url: PAGE_ENTRY_LIST })
-          }, 1500)
-        })
-        .catch(() => {})
-        .finally(() => {
-          submitting.value = false
-        })
+      submitGuard.run(async () => {
+        await submitEntryApply(buildEntrySubmitPayload(form))
+        uni.showToast({ title: '提交成功，请等待审核', icon: 'none', duration: 2500 })
+        setTimeout(() => {
+          uni.redirectTo({ url: PAGE_ENTRY_LIST })
+        }, 1500)
+      })
     }
   })
 }

shop-app/subpackage/account/password.vue

@@ -43,6 +43,10 @@ import { onLoad } from '@dcloudio/uni-app'
 import { changeMemberPassword } from '@/api/member'
 import { ensureApiToken } from '@/utils/apiAuth'
 import { validatePassword } from '@/utils/memberValidate'
+import { useActionGuard } from '@/utils/actionGuard'
+
+const saveGuard = useActionGuard()
+const saving = saveGuard.locked
 
 const form = reactive({
   oldPassword: '',
@@ -50,8 +54,6 @@ const form = reactive({
   confirmPassword: ''
 })
 
-const saving = ref(false)
-
 onLoad(() => {
   ensureApiToken()
 })
@@ -78,21 +80,16 @@ function validate() {
 }
 
 function handleSave() {
-  if (saving.value || !validate()) return
-  saving.value = true
-  changeMemberPassword({
-    oldPassword: form.oldPassword,
-    newPassword: form.newPassword,
-    confirmPassword: form.confirmPassword
-  })
-    .then(() => {
-      uni.showToast({ title: '修改成功', icon: 'none' })
-      setTimeout(() => uni.navigateBack(), 800)
-    })
-    .catch(() => {})
-    .finally(() => {
-      saving.value = false
+  saveGuard.run(async () => {
+    if (!validate()) return
+    await changeMemberPassword({
+      oldPassword: form.oldPassword,
+      newPassword: form.newPassword,
+      confirmPassword: form.confirmPassword
     })
+    uni.showToast({ title: '修改成功', icon: 'none' })
+    setTimeout(() => uni.navigateBack(), 800)
+  })
 }
 </script>
 

shop-app/subpackage/account/profile.vue

@@ -57,6 +57,9 @@ import { useUserStore } from '@/store/user'
 import { ensureApiToken } from '@/utils/apiAuth'
 import { GENDER_OPTIONS } from '@/utils/entryConstants'
 import ImageUpload from '@/components/mine/ImageUpload.vue'
+import { useActionGuard } from '@/utils/actionGuard'
+
+const saveGuard = useActionGuard()
 
 const profile = reactive({
   memberId: '',
@@ -71,7 +74,7 @@ const form = reactive({
   sex: ''
 })
 
-const saving = ref(false)
+const saving = saveGuard.locked
 const genderLabels = GENDER_OPTIONS.map((g) => g.label)
 const genderIndex = ref(-1)
 /** 昵称最长 30 字（对齐功能需求 MS-P2） */
@@ -130,25 +133,18 @@ function validate() {
 }
 
 function handleSave() {
-  if (saving.value || !validate()) return
-  saving.value = true
-  updateMemberProfile({
-    nickName: form.nickName.trim(),
-    avatar: form.avatar,
-    email: (form.email || '').trim(),
-    sex: form.sex
-  })
-    .then(() => {
-      uni.showToast({ title: '保存成功', icon: 'none' })
-      return userStore.fetchUserInfo()
-    })
-    .then(() => {
-      setTimeout(() => uni.navigateBack(), 800)
-    })
-    .catch(() => {})
-    .finally(() => {
-      saving.value = false
+  saveGuard.run(async () => {
+    if (!validate()) return
+    await updateMemberProfile({
+      nickName: form.nickName.trim(),
+      avatar: form.avatar,
+      email: (form.email || '').trim(),
+      sex: form.sex
     })
+    uni.showToast({ title: '保存成功', icon: 'none' })
+    await userStore.fetchUserInfo()
+    setTimeout(() => uni.navigateBack(), 800)
+  })
 }
 </script>
 

shop-app/subpackage/account/register.vue

@@ -81,6 +81,7 @@
 
 					<view
 						:class="['auth-btn', { 'auth-btn--loading': loading }]"
+						:disabled="loading"
 						@click="handleRegister"
 					>
 						<text class="auth-btn__txt">{{ loading ? '提交中…' : '注 册' }}</text>
@@ -105,7 +106,10 @@ import { validateMobile, validatePassword } from '@/utils/memberValidate'
 import { PAGE_LOGIN } from '@/utils/pageRoute'
 import AgreementBlock from '@/components/account/AgreementBlock.vue'
 
-const loading = ref(false)
+import { useActionGuard } from '@/utils/actionGuard'
+
+const registerGuard = useActionGuard()
+const loading = registerGuard.locked
 const agreement = reactive({
   enabled: false,
   registrationOpen: true,
@@ -161,27 +165,21 @@ function validateForm() {
 }
 
 function handleRegister() {
-  if (!agreement.registrationOpen || loading.value || !validateForm()) {
-    return
-  }
-  loading.value = true
-  memberRegister({
-    mobile: form.mobile.trim(),
-    password: form.password,
-    confirmPassword: form.confirmPassword,
-    memberCode: (form.memberCode || '').trim() || undefined,
-    agreementAccepted: agreement.enabled ? form.agreementAccepted : true
-  })
-    .then(() => {
-      uni.showToast({ title: '注册成功，请登录', icon: 'none', duration: 2000 })
-      setTimeout(() => {
-        goLogin()
-      }, 1500)
-    })
-    .catch(() => {})
-    .finally(() => {
-      loading.value = false
+  if (!agreement.registrationOpen) return
+  registerGuard.run(async () => {
+    if (!validateForm()) return
+    await memberRegister({
+      mobile: form.mobile.trim(),
+      password: form.password,
+      confirmPassword: form.confirmPassword,
+      memberCode: (form.memberCode || '').trim() || undefined,
+      agreementAccepted: agreement.enabled ? form.agreementAccepted : true
     })
+    uni.showToast({ title: '注册成功，请登录', icon: 'none', duration: 2000 })
+    setTimeout(() => {
+      goLogin()
+    }, 1500)
+  })
 }
 </script>
 

shop-app/subpackage/goods/detail.vue

@@ -139,6 +139,7 @@
 
 			<detail-bottom-bar
 				:disabled="!canOperate"
+				:busy="tradeGuard.locked"
 				@shop="onEnterShop"
 				@cart="onAddCart"
 				@buy="onBuyNow"
@@ -164,7 +165,7 @@
 						integer
 					/>
 				</view>
-				<button class="qty-popup__btn" @click="confirmQty">确定</button>
+				<button class="qty-popup__btn" :disabled="tradeGuard.locked" @click="confirmQty">确定</button>
 			</view>
 		</u-popup>
 	</view>
@@ -185,8 +186,11 @@ import { addCartItem } from '@/api/cart'
 import { PAGE_GOODS_REVIEWS, PAGE_CHECKOUT } from '@/utils/pageRoute'
 import { goShopHome } from '@/utils/shopNav'
 import ReviewCard from '@/components/goods/ReviewCard.vue'
+import { useActionGuard } from '@/utils/actionGuard'
 import DetailBottomBar from '@/components/goods/DetailBottomBar.vue'
 
+const tradeGuard = useActionGuard()
+
 const goodsId = ref('')
 const detail = ref(null)
 const pageLoading = ref(true)
@@ -292,14 +296,16 @@ function openQtyPopup() {
 }
 
 function confirmQty() {
-	qtyPopupShow.value = false
-	const action = pendingAction.value
-	pendingAction.value = ''
-	if (action === 'cart') {
-		doAddCart()
-	} else if (action === 'buy') {
-		doBuyNow()
-	}
+	tradeGuard.run(async () => {
+		qtyPopupShow.value = false
+		const action = pendingAction.value
+		pendingAction.value = ''
+		if (action === 'cart') {
+			await doAddCart()
+		} else if (action === 'buy') {
+			await doBuyNow()
+		}
+	})
 }
 
 async function onAddCart() {
@@ -312,7 +318,7 @@ async function onAddCart() {
 		openQtyPopup()
 		return
 	}
-	await doAddCart()
+	tradeGuard.run(() => doAddCart())
 }
 
 async function doAddCart() {

shop-app/subpackage/order/aftersale-submit.vue

@@ -92,14 +92,17 @@ import {
 } from '@/constants/order'
 import { goAftersaleDetail } from '@/utils/orderNav'
 import OrderGoodsRow from '@/components/order/OrderGoodsRow.vue'
+import { useActionGuard } from '@/utils/actionGuard'
 import ImageUploadGrid from '@/components/order/ImageUploadGrid.vue'
 
+const submitGuard = useActionGuard()
+
 const orderId = ref('')
 const orderItemId = ref('')
 const orderItem = ref(null)
 const payAmount = ref(0)
 const pageLoading = ref(true)
-const submitting = ref(false)
+const submitting = submitGuard.locked
 
 const applyType = ref(AFTERSALE_APPLY_TYPE.REFUND_UNSHIPPED)
 const applyReason = ref('')
@@ -154,19 +157,17 @@ async function loadOrderItem() {
 	}
 }
 
-async function onSubmit() {
-	if (!applyReason.value) {
-		uni.showToast({ title: '请选择售后原因', icon: 'none' })
-		return
-	}
-	const amount = Number(applyAmountInput.value)
-	if (!amount || amount <= 0) {
-		uni.showToast({ title: '请填写申请金额', icon: 'none' })
-		return
-	}
-	if (submitting.value) return
-	submitting.value = true
-	try {
+function onSubmit() {
+	submitGuard.run(async () => {
+		if (!applyReason.value) {
+			uni.showToast({ title: '请选择售后原因', icon: 'none' })
+			return
+		}
+		const amount = Number(applyAmountInput.value)
+		if (!amount || amount <= 0) {
+			uni.showToast({ title: '请填写申请金额', icon: 'none' })
+			return
+		}
 		const body = {
 			orderId: orderId.value,
 			orderItemId: orderItemId.value,
@@ -189,11 +190,7 @@ async function onSubmit() {
 				uni.navigateBack()
 			}
 		}, 500)
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		submitting.value = false
-	}
+	})
 }
 
 onLoad((options) => {

shop-app/subpackage/order/checkout-cart.vue

@@ -120,15 +120,19 @@ import {
 } from '@/constants/checkout'
 import { ensureApiToken } from '@/utils/apiAuth'
 import { PAGE_ADDRESS_EDIT, PAGE_PAY_RESULT } from '@/utils/pageRoute'
+import { useActionGuard } from '@/utils/actionGuard'
 import AddressBar from '@/components/order/AddressBar.vue'
 import CheckoutMultiGoodsRow from '@/components/order/CheckoutMultiGoodsRow.vue'
 
+const submitGuard = useActionGuard()
+const payGuard = useActionGuard()
+
 const cartItemIds = ref([])
 const selectedAddressId = ref(null)
 const preview = ref(null)
 const pageLoading = ref(true)
 const pageError = ref('')
-const submitting = ref(false)
+const submitting = submitGuard.locked
 const previewing = ref(false)
 const scrollHeight = ref('600px')
 
@@ -138,7 +142,7 @@ const addressOptions = ref([])
 const payModalShow = ref(false)
 const payModalContent = ref('')
 const pendingOrderId = ref(null)
-const paying = ref(false)
+const paying = payGuard.locked
 
 let previewTimer = null
 
@@ -264,31 +268,24 @@ function goAddAddress() {
 	uni.navigateTo({ url: `${PAGE_ADDRESS_EDIT}?mode=add` })
 }
 
-async function onSubmit() {
-	if (!selectedAddressId.value) {
-		uni.showToast({ title: '请选择收货地址', icon: 'none' })
-		return
-	}
-	if (submitting.value) return
-	submitting.value = true
-	try {
+function onSubmit() {
+	submitGuard.run(async () => {
+		if (!selectedAddressId.value) {
+			uni.showToast({ title: '请选择收货地址', icon: 'none' })
+			return
+		}
 		const res = await submitCheckout(buildSubmitBody())
 		const data = res.data || {}
 		pendingOrderId.value = data.orderId
 		payModalContent.value = `订单号：${data.orderNo || '—'}\n应付金额：¥${data.payAmount != null ? data.payAmount : preview.value?.payAmountText || '—'}`
 		payModalShow.value = true
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		submitting.value = false
-	}
+	})
 }
 
-async function onConfirmPay() {
-	if (!pendingOrderId.value || paying.value) return
-	paying.value = true
-	payModalShow.value = false
-	try {
+function onConfirmPay() {
+	if (!pendingOrderId.value) return
+	payGuard.run(async () => {
+		payModalShow.value = false
 		await payOrder(pendingOrderId.value)
 		try {
 			uni.removeStorageSync(CART_CHECKOUT_IDS_KEY)
@@ -298,27 +295,18 @@ async function onConfirmPay() {
 		uni.redirectTo({
 			url: `${PAGE_PAY_RESULT}?status=success&orderId=${pendingOrderId.value}`
 		})
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		paying.value = false
-	}
+	})
 }
 
-async function onCancelPay() {
-	if (!pendingOrderId.value || paying.value) return
-	paying.value = true
-	payModalShow.value = false
-	try {
+function onCancelPay() {
+	if (!pendingOrderId.value) return
+	payGuard.run(async () => {
+		payModalShow.value = false
 		await cancelPay(pendingOrderId.value)
 		uni.redirectTo({
 			url: `${PAGE_PAY_RESULT}?status=closed&orderId=${pendingOrderId.value}`
 		})
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		paying.value = false
-	}
+	})
 }
 
 function onBack() {

shop-app/subpackage/order/checkout.vue

@@ -130,9 +130,13 @@ import {
 } from '@/constants/checkout'
 import { ensureApiToken } from '@/utils/apiAuth'
 import { PAGE_ADDRESS_EDIT, PAGE_PAY_RESULT } from '@/utils/pageRoute'
+import { useActionGuard } from '@/utils/actionGuard'
 import AddressBar from '@/components/order/AddressBar.vue'
 import CheckoutGoodsRow from '@/components/order/CheckoutGoodsRow.vue'
 
+const submitGuard = useActionGuard()
+const payGuard = useActionGuard()
+
 const goodsId = ref('')
 const quantity = ref(1)
 const specText = ref('')
@@ -141,7 +145,7 @@ const buyerRemark = ref('')
 const preview = ref(null)
 const pageLoading = ref(true)
 const pageError = ref('')
-const submitting = ref(false)
+const submitting = submitGuard.locked
 const previewing = ref(false)
 const scrollHeight = ref('600px')
 const remarkMax = CHECKOUT_REMARK_MAX
@@ -152,7 +156,7 @@ const addressOptions = ref([])
 const payModalShow = ref(false)
 const payModalContent = ref('')
 const pendingOrderId = ref(null)
-const paying = ref(false)
+const paying = payGuard.locked
 
 let previewTimer = null
 
@@ -255,56 +259,40 @@ function goAddAddress() {
 	uni.navigateTo({ url: `${PAGE_ADDRESS_EDIT}?mode=add` })
 }
 
-async function onSubmit() {
-	if (!selectedAddressId.value) {
-		uni.showToast({ title: '请选择收货地址', icon: 'none' })
-		return
-	}
-	if (submitting.value) return
-	submitting.value = true
-	try {
+function onSubmit() {
+	submitGuard.run(async () => {
+		if (!selectedAddressId.value) {
+			uni.showToast({ title: '请选择收货地址', icon: 'none' })
+			return
+		}
 		const res = await submitCheckout(buildSubmitBody())
 		const data = res.data || {}
 		pendingOrderId.value = data.orderId
 		payModalContent.value = `订单号：${data.orderNo || '—'}\n应付金额：¥${data.payAmount != null ? data.payAmount : preview.value?.payAmountText || '—'}`
 		payModalShow.value = true
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		submitting.value = false
-	}
+	})
 }
 
-async function onConfirmPay() {
-	if (!pendingOrderId.value || paying.value) return
-	paying.value = true
-	payModalShow.value = false
-	try {
+function onConfirmPay() {
+	if (!pendingOrderId.value) return
+	payGuard.run(async () => {
+		payModalShow.value = false
 		await payOrder(pendingOrderId.value)
 		uni.redirectTo({
 			url: `${PAGE_PAY_RESULT}?status=success&orderId=${pendingOrderId.value}`
 		})
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		paying.value = false
-	}
+	})
 }
 
-async function onCancelPay() {
-	if (!pendingOrderId.value || paying.value) return
-	paying.value = true
-	payModalShow.value = false
-	try {
+function onCancelPay() {
+	if (!pendingOrderId.value) return
+	payGuard.run(async () => {
+		payModalShow.value = false
 		await cancelPay(pendingOrderId.value)
 		uni.redirectTo({
 			url: `${PAGE_PAY_RESULT}?status=closed&orderId=${pendingOrderId.value}`
 		})
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		paying.value = false
-	}
+	})
 }
 
 function onBack() {

shop-app/subpackage/order/detail.vue

@@ -110,13 +110,16 @@ import { ORDER_ACTION } from '@/constants/order'
 import { runOrderAction, openPayModal } from '@/utils/orderAction'
 import OrderStatusBar from '@/components/order/OrderStatusBar.vue'
 import OrderGoodsRow from '@/components/order/OrderGoodsRow.vue'
+import { useActionGuard } from '@/utils/actionGuard'
 import OrderActionBar from '@/components/order/OrderActionBar.vue'
 
+const actionGuard = useActionGuard()
+
 const orderId = ref('')
 const detail = ref(null)
 const pageLoading = ref(true)
 const pageError = ref('')
-const actionLoading = ref(false)
+const actionLoading = actionGuard.locked
 const scrollHeight = ref('600px')
 
 const statusSubText = computed(() => {
@@ -157,11 +160,10 @@ async function loadDetail() {
 	}
 }
 
-async function onAction(code) {
-	if (!detail.value || actionLoading.value) return
-	if (code === ORDER_ACTION.PAY) {
-		actionLoading.value = true
-		try {
+function onAction(code) {
+	if (!detail.value) return
+	actionGuard.run(async () => {
+		if (code === ORDER_ACTION.PAY) {
 			const result = await openPayModal(
 				detail.value.orderId,
 				detail.value.orderNo,
@@ -170,16 +172,14 @@ async function onAction(code) {
 			if (result && result.status) {
 				await loadDetail()
 			}
-		} finally {
-			actionLoading.value = false
+			return
 		}
-		return
-	}
-	await runOrderAction(code, {
-		orderId: detail.value.orderId,
-		firstItem: detail.value.items && detail.value.items[0],
-		items: detail.value.items,
-		onRefresh: loadDetail
+		await runOrderAction(code, {
+			orderId: detail.value.orderId,
+			firstItem: detail.value.items && detail.value.items[0],
+			items: detail.value.items,
+			onRefresh: loadDetail
+		})
 	})
 }
 

shop-app/subpackage/order/list.vue

@@ -102,9 +102,12 @@ import { ensureApiToken } from '@/utils/apiAuth'
 import { goOrderDetail, goReviewList, goAftersaleList } from '@/utils/orderNav'
 import { runOrderAction, openPayModal } from '@/utils/orderAction'
 import { PAGE_HOME } from '@/utils/pageRoute'
+import { useActionGuard } from '@/utils/actionGuard'
 import OrderGoodsRow from '@/components/order/OrderGoodsRow.vue'
 import OrderActionBar from '@/components/order/OrderActionBar.vue'
 
+const actionGuard = useActionGuard()
+
 const tabs = ORDER_LIST_TABS
 const activeTab = ref('ALL')
 const list = ref([])
@@ -113,7 +116,7 @@ const loadingMore = ref(false)
 const finished = ref(false)
 const loadFailed = ref(false)
 const refreshing = ref(false)
-const actionLoading = ref(false)
+const actionLoading = actionGuard.locked
 const pageNum = ref(1)
 const scrollHeight = ref('600px')
 
@@ -188,24 +191,20 @@ function onCardClick(card) {
 	goOrderDetail(card.orderId)
 }
 
-async function onAction(code, card) {
-	if (actionLoading.value) return
-	if (code === ORDER_ACTION.PAY) {
-		actionLoading.value = true
-		try {
+function onAction(code, card) {
+	actionGuard.run(async () => {
+		if (code === ORDER_ACTION.PAY) {
 			const result = await openPayModal(card.orderId, card.orderNo, card.payAmountText)
 			if (result && result.status) {
 				await reloadList(true)
 			}
-		} finally {
-			actionLoading.value = false
+			return
 		}
-		return
-	}
-	await runOrderAction(code, {
-		orderId: card.orderId,
-		firstItem: card.firstItem,
-		onRefresh: () => reloadList(true)
+		await runOrderAction(code, {
+			orderId: card.orderId,
+			firstItem: card.firstItem,
+			onRefresh: () => reloadList(true)
+		})
 	})
 }
 

shop-app/subpackage/order/review-edit.vue

@@ -46,26 +46,27 @@ import { onLoad } from '@dcloudio/uni-app'
 import { submitReview } from '@/api/orderReview'
 import { ensureApiToken } from '@/utils/apiAuth'
 import { REVIEW_SCORE_MAX, REVIEW_PIC_MAX, REVIEW_CONTENT_MAX } from '@/constants/order'
+import { useActionGuard } from '@/utils/actionGuard'
 import ImageUploadGrid from '@/components/order/ImageUploadGrid.vue'
 
+const submitGuard = useActionGuard()
+
 const orderId = ref('')
 const score = ref(5)
 const content = ref('')
 const pics = ref([])
-const submitting = ref(false)
+const submitting = submitGuard.locked
 const pageLoading = ref(false)
 const scoreMax = REVIEW_SCORE_MAX
 const picMax = REVIEW_PIC_MAX
 const contentMax = REVIEW_CONTENT_MAX
 
-async function onSubmit() {
-	if (score.value < 1) {
-		uni.showToast({ title: '请选择星级', icon: 'none' })
-		return
-	}
-	if (submitting.value) return
-	submitting.value = true
-	try {
+function onSubmit() {
+	submitGuard.run(async () => {
+		if (score.value < 1) {
+			uni.showToast({ title: '请选择星级', icon: 'none' })
+			return
+		}
 		await submitReview(orderId.value, {
 			score: score.value,
 			content: content.value.trim(),
@@ -75,11 +76,7 @@ async function onSubmit() {
 		setTimeout(() => {
 			uni.navigateBack()
 		}, 500)
-	} catch (e) {
-		// request 已 Toast
-	} finally {
-		submitting.value = false
-	}
+	})
 }
 
 onLoad((options) => {

shop-app/subpackage/search/index.vue

@@ -59,6 +59,9 @@ import {
   clearSearchHistory
 } from '@/utils/searchHistory'
 import { goSearchResult, navigateBackFromSearchIndex } from '@/utils/searchNav'
+import { useActionGuard } from '@/utils/actionGuard'
+
+const searchGuard = useActionGuard()
 
 const placeholder = SEARCH_PLACEHOLDER
 const keyword = ref('')
@@ -84,7 +87,7 @@ function submitSearch() {
 }
 
 function onSubmit() {
-  submitSearch()
+  searchGuard.run(() => submitSearch())
 }
 
 function onHistoryTap(text) {

shop-app/subpackage/shop/search.vue

@@ -44,6 +44,9 @@ import { SHOP_SEARCH_PLACEHOLDER } from '@/constants/shop'
 import { goGoodsDetail } from '@/utils/goodsDetail'
 import { smartNavigateBack } from '@/utils/navBack'
 import ShopGoodsBlock from '@/components/shop/ShopGoodsBlock.vue'
+import { useActionGuard } from '@/utils/actionGuard'
+
+const searchGuard = useActionGuard()
 
 const shopId = ref('')
 const keyword = ref('')
@@ -69,14 +72,16 @@ function onBack() {
 }
 
 function onSubmit() {
-	const text = (keyword.value || '').trim()
-	if (!text) {
-		uni.showToast({ title: '请输入搜索内容', icon: 'none' })
-		return
-	}
-	searchKeyword.value = text
-	searched.value = true
-	scrollKey.value += 1
+	searchGuard.run(() => {
+		const text = (keyword.value || '').trim()
+		if (!text) {
+			uni.showToast({ title: '请输入搜索内容', icon: 'none' })
+			return
+		}
+		searchKeyword.value = text
+		searched.value = true
+		scrollKey.value += 1
+	})
 }
 
 function onGoodsClick(item) {

shop-app/utils/actionGuard.js

@@ -0,0 +1,40 @@
+import { ref } from 'vue'
+
+/** 提交类按钮默认防抖间隔（毫秒） */
+export const ACTION_GUARD_DEBOUNCE_MS = 300
+
+/**
+ * 提交/支付类操作：防抖 + 执行期间加锁（禁止重复点击）
+ * @param {number} debounceMs 两次有效触发的最小间隔
+ * @returns {{ locked: import('vue').Ref<boolean>, run: Function, wrap: Function }}
+ */
+export function useActionGuard(debounceMs = ACTION_GUARD_DEBOUNCE_MS) {
+  const locked = ref(false)
+  let lastAt = 0
+
+  /**
+   * 在锁内执行异步任务；校验失败可在 task 内 return，仍会释放锁
+   * @param {() => Promise<void|boolean>|void|boolean} task
+   * @returns {Promise<boolean>} 是否实际执行了 task
+   */
+  async function run(task) {
+    if (locked.value) return false
+    const now = Date.now()
+    if (now - lastAt < debounceMs) return false
+    lastAt = now
+    locked.value = true
+    try {
+      await task()
+      return true
+    } finally {
+      locked.value = false
+    }
+  }
+
+  /** 包装函数，适合直接绑 @click */
+  function wrap(fn) {
+    return (...args) => run(() => fn(...args))
+  }
+
+  return { locked, run, wrap }
+}

shop-app/utils/orderAction.js

@@ -1,4 +1,8 @@
 import { payOrder, cancelPay, confirmReceive } from '@/api/order'
+import { useActionGuard } from '@/utils/actionGuard'
+
+const payModalGuard = useActionGuard()
+const confirmReceiveGuard = useActionGuard()
 import { ORDER_ACTION } from '@/constants/order'
 import { goGoodsDetail } from '@/utils/goodsDetail'
 import { goReviewEdit, goAftersaleSubmit } from '@/utils/orderNav'
@@ -71,32 +75,34 @@ function doConfirmReceive(orderId, onRefresh) {
     uni.showModal({
       title: '确认收货',
       content: '请确认您已收到商品',
-      success: async (res) => {
+      success: (res) => {
         if (!res.confirm) {
           resolve()
           return
         }
-        try {
-          await confirmReceive(orderId)
-          uni.showToast({ title: '已确认收货', icon: 'success' })
-          if (typeof onRefresh === 'function') {
-            await onRefresh()
-          }
-          uni.showModal({
-            title: '提示',
-            content: '交易成功，是否去评价？',
-            confirmText: '去评价',
-            cancelText: '稍后',
-            success: (r) => {
-              if (r.confirm) {
-                goReviewEdit(orderId)
-              }
+        confirmReceiveGuard.run(async () => {
+          try {
+            await confirmReceive(orderId)
+            uni.showToast({ title: '已确认收货', icon: 'success' })
+            if (typeof onRefresh === 'function') {
+              await onRefresh()
             }
-          })
-        } catch (e) {
-          // request 已 Toast
-        }
-        resolve()
+            uni.showModal({
+              title: '提示',
+              content: '交易成功，是否去评价？',
+              confirmText: '去评价',
+              cancelText: '稍后',
+              success: (r) => {
+                if (r.confirm) {
+                  goReviewEdit(orderId)
+                }
+              }
+            })
+          } catch (e) {
+            // request 已 Toast
+          }
+          resolve()
+        })
       }
     })
   })
@@ -110,20 +116,22 @@ export function openPayModal(orderId, orderNo, payAmountText) {
       content: `订单号：${orderNo || '—'}\n应付金额：¥${payAmountText || '—'}`,
       confirmText: '确认支付',
       cancelText: '取消支付',
-      success: async (res) => {
-        try {
-          if (res.confirm) {
-            await payOrder(orderId)
-            uni.showToast({ title: '支付成功', icon: 'success' })
-            resolve({ status: 'success' })
-            return
+      success: (res) => {
+        payModalGuard.run(async () => {
+          try {
+            if (res.confirm) {
+              await payOrder(orderId)
+              uni.showToast({ title: '支付成功', icon: 'success' })
+              resolve({ status: 'success' })
+              return
+            }
+            await cancelPay(orderId)
+            uni.showToast({ title: '订单已关闭', icon: 'none' })
+            resolve({ status: 'closed' })
+          } catch (e) {
+            resolve({ status: 'error' })
           }
-          await cancelPay(orderId)
-          uni.showToast({ title: '订单已关闭', icon: 'none' })
-          resolve({ status: 'closed' })
-        } catch (e) {
-          resolve({ status: 'error' })
-        }
+        })
       },
       fail: () => resolve({ status: 'cancel' })
     })