From fe8ee5692ebc3eb45a7392700e6bf5b50bec57a4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E5=90=B4=E6=98=8A=E5=A4=A9?= <442384644@qq.com>
Date: Tue, 29 Sep 2026 17:34:04 +0800
Subject: [PATCH] =?UTF-8?q?fix(=E7=AE=A1=E7=90=86=E7=AB=AF):=20=E8=A1=A8?=
 =?UTF-8?q?=E5=8D=95=E6=A8=A1=E6=9D=BF=20ref=20=E4=B8=8E=E6=95=B0=E6=8D=AE?=
 =?UTF-8?q?=E5=AF=B9=E8=B1=A1=E5=90=8C=E5=90=8D=E5=86=B2=E7=AA=81=E5=AF=BC?=
 =?UTF-8?q?=E8=87=B4=E6=8E=A5=E5=8F=A3=E5=8F=82=E6=95=B0=E9=94=99=E4=B9=B1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Vue3 迁移地雷批量修复：el-form 模板 ref="formValidate" 会把表单组件实例
覆盖进 script setup 同名数据对象 ref，挂载后请求序列化整个实例（携带
validate/resetFields 等方法源码），真实筛选字段丢失。统一改名为 formRef，
涉及财务模块及统计、直播、积分订单备注共 13 个页面
---
 frontend/admin/src/pages/finance/balance/index.vue              | 2 +-
 frontend/admin/src/pages/finance/billingRecords/index.vue       | 2 +-
 frontend/admin/src/pages/finance/capitalFlow/index.vue          | 2 +-
 .../src/pages/finance/commission/handle/commissionDetails.vue   | 2 +-
 frontend/admin/src/pages/finance/commission/index.vue           | 2 +-
 .../src/pages/finance/components/commissionDetails/index.vue    | 2 +-
 .../admin/src/pages/finance/financialRecords/bill/index.vue     | 2 +-
 .../admin/src/pages/finance/financialRecords/recharge/index.vue | 2 +-
 frontend/admin/src/pages/finance/userExtract/index.vue          | 2 +-
 .../admin/src/pages/plugin/wechat_mini/pages/live/goods/add.vue | 2 +-
 .../src/pages/plugin/wechat_mini/pages/live/room/index.vue      | 2 +-
 frontend/admin/src/pages/statistic/integral/index.vue           | 2 +-
 12 files changed, 12 insertions(+), 12 deletions(-)

diff --git a/frontend/admin/src/pages/finance/balance/index.vue b/frontend/admin/src/pages/finance/balance/index.vue
index b83c8c9be..9ae8d69f8 100644
--- a/frontend/admin/src/pages/finance/balance/index.vue
+++ b/frontend/admin/src/pages/finance/balance/index.vue
@@ -3,7 +3,7 @@
     <el-card :bordered="false" shadow="never" class="ivu-mb-16" :body-style="{ padding: 0 }">
       <div class="padding-add">
         <el-form
-          ref="formValidate"
+          ref="formRef"
           :model="formValidate"
           :label-width="labelWidth"
           label-position="right"
diff --git a/frontend/admin/src/pages/finance/billingRecords/index.vue b/frontend/admin/src/pages/finance/billingRecords/index.vue
index 7cc6d055b..e272b03d3 100644
--- a/frontend/admin/src/pages/finance/billingRecords/index.vue
+++ b/frontend/admin/src/pages/finance/billingRecords/index.vue
@@ -3,7 +3,7 @@
     <el-card :bordered="false" shadow="never" :body-style="{ padding: 0 }">
       <div class="padding-add">
         <el-form
-          ref="formValidate"
+          ref="formRef"
           :model="formValidate"
           :label-width="labelWidth"
           :label-position="labelPosition"
diff --git a/frontend/admin/src/pages/finance/capitalFlow/index.vue b/frontend/admin/src/pages/finance/capitalFlow/index.vue
index ce213ee90..dae63e121 100644
--- a/frontend/admin/src/pages/finance/capitalFlow/index.vue
+++ b/frontend/admin/src/pages/finance/capitalFlow/index.vue
@@ -3,7 +3,7 @@
     <el-card :bordered="false" shadow="never" :body-style="{ padding: 0 }">
       <div class="padding-add">
         <el-form
-          ref="formValidate"
+          ref="formRef"
           :model="formValidate"
           :label-width="labelWidth"
           label-position="right"
diff --git a/frontend/admin/src/pages/finance/commission/handle/commissionDetails.vue b/frontend/admin/src/pages/finance/commission/handle/commissionDetails.vue
index 719338933..8b1060c47 100644
--- a/frontend/admin/src/pages/finance/commission/handle/commissionDetails.vue
+++ b/frontend/admin/src/pages/finance/commission/handle/commissionDetails.vue
@@ -15,7 +15,7 @@
         </div>
       </div>
       <el-divider direction="vertical" dashed />
-      <el-form ref="formValidate" label-width="75px" :label-position="labelPosition" class="tabform" @submit.prevent>
+      <el-form ref="formRef" label-width="75px" :label-position="labelPosition" class="tabform" @submit.prevent>
         <el-row :gutter="24">
           <!--                    <el-col :span="8">-->
           <!--                        <el-form-item label="订单号/昵称：">-->
diff --git a/frontend/admin/src/pages/finance/commission/index.vue b/frontend/admin/src/pages/finance/commission/index.vue
index 259d371f2..499f2bfcc 100644
--- a/frontend/admin/src/pages/finance/commission/index.vue
+++ b/frontend/admin/src/pages/finance/commission/index.vue
@@ -2,7 +2,7 @@
   <div>
     <el-card :bordered="false" shadow="never" :body-style="{ padding: 0 }">
       <div class="padding-add">
-        <el-form ref="formValidate" :label-width="labelWidth" label-position="right" inline @submit.prevent>
+        <el-form ref="formRef" :label-width="labelWidth" label-position="right" inline @submit.prevent>
           <el-form-item label="昵称/ID：">
             <el-input placeholder="请输入" v-model="formValidate.nickname" clearable class="form_content_width" />
           </el-form-item>
diff --git a/frontend/admin/src/pages/finance/components/commissionDetails/index.vue b/frontend/admin/src/pages/finance/components/commissionDetails/index.vue
index fcf7ac6c4..0176c1c98 100644
--- a/frontend/admin/src/pages/finance/components/commissionDetails/index.vue
+++ b/frontend/admin/src/pages/finance/components/commissionDetails/index.vue
@@ -1,7 +1,7 @@
 <template>
   <div>
     <el-form
-      ref="formValidate"
+      ref="formRef"
       :label-width="labelWidth"
       :label-position="labelPosition"
       class="tabform"
diff --git a/frontend/admin/src/pages/finance/financialRecords/bill/index.vue b/frontend/admin/src/pages/finance/financialRecords/bill/index.vue
index 74630a8dc..7e87adcf9 100644
--- a/frontend/admin/src/pages/finance/financialRecords/bill/index.vue
+++ b/frontend/admin/src/pages/finance/financialRecords/bill/index.vue
@@ -11,7 +11,7 @@
     </div>
     <el-card :bordered="false" shadow="never">
       <el-form
-        ref="formValidate"
+        ref="formRef"
         :model="formValidate"
         :label-width="labelWidth"
         :label-position="labelPosition"
diff --git a/frontend/admin/src/pages/finance/financialRecords/recharge/index.vue b/frontend/admin/src/pages/finance/financialRecords/recharge/index.vue
index 670d0382a..ee00caa37 100644
--- a/frontend/admin/src/pages/finance/financialRecords/recharge/index.vue
+++ b/frontend/admin/src/pages/finance/financialRecords/recharge/index.vue
@@ -3,7 +3,7 @@
     <el-card :bordered="false" shadow="never" class="ivu-mb-16" :body-style="{ padding: 0 }">
       <div class="padding-add">
         <el-form
-          ref="formValidate"
+          ref="formRef"
           :model="formValidate"
           :label-width="labelWidth"
           :label-position="labelPosition"
diff --git a/frontend/admin/src/pages/finance/userExtract/index.vue b/frontend/admin/src/pages/finance/userExtract/index.vue
index 01184a790..c8ef71831 100644
--- a/frontend/admin/src/pages/finance/userExtract/index.vue
+++ b/frontend/admin/src/pages/finance/userExtract/index.vue
@@ -3,7 +3,7 @@
     <el-card :bordered="false" shadow="never" class="ivu-mb-16" :body-style="{ padding: 0 }">
       <div class="padding-add">
         <el-form
-          ref="formValidate"
+          ref="formRef"
           :model="formValidate"
           :label-width="labelWidth"
           label-position="right"
diff --git a/frontend/admin/src/pages/plugin/wechat_mini/pages/live/goods/add.vue b/frontend/admin/src/pages/plugin/wechat_mini/pages/live/goods/add.vue
index 51b5d1a64..5afc1621f 100644
--- a/frontend/admin/src/pages/plugin/wechat_mini/pages/live/goods/add.vue
+++ b/frontend/admin/src/pages/plugin/wechat_mini/pages/live/goods/add.vue
@@ -8,7 +8,7 @@
     ></pages-header>
     <el-card :bordered="false" shadow="never" class="mt16">
       <el-form
-        ref="formValidate"
+        ref="formRef"
         :model="formValidate"
         :label-width="labelWidth"
         :label-position="labelPosition"
diff --git a/frontend/admin/src/pages/plugin/wechat_mini/pages/live/room/index.vue b/frontend/admin/src/pages/plugin/wechat_mini/pages/live/room/index.vue
index 7ee1e40e9..39bfca983 100644
--- a/frontend/admin/src/pages/plugin/wechat_mini/pages/live/room/index.vue
+++ b/frontend/admin/src/pages/plugin/wechat_mini/pages/live/room/index.vue
@@ -3,7 +3,7 @@
     <el-card :bordered="false" shadow="never" :body-style="{ padding: 0 }">
       <div class="padding-add">
         <el-form
-          ref="formValidate"
+          ref="formRef"
           :model="formValidate"
           :label-width="labelWidth"
           label-position="right"
diff --git a/frontend/admin/src/pages/statistic/integral/index.vue b/frontend/admin/src/pages/statistic/integral/index.vue
index 182e0a6cf..7a9fa5b37 100644
--- a/frontend/admin/src/pages/statistic/integral/index.vue
+++ b/frontend/admin/src/pages/statistic/integral/index.vue
@@ -1,7 +1,7 @@
 <template>
   <div v-loading="spinShow">
     <el-card :bordered="false" shadow="never" class="ivu-mt">
-      <el-form ref="formValidate" :model="formValidate" class="tabform" @submit.prevent>
+      <el-form ref="formRef" :model="formValidate" class="tabform" @submit.prevent>
         <el-row :gutter="24">
           <el-col :span="24">
             <el-form-item label="订单时间：">