fix(小程序): 修正 v-for :key 表达式告警,恢复列表 wx:key

非 h5 平台的 :key 只接受简单属性名,模板字面量与运算表达式会被编译器
整条丢弃(uni-template-compiler 的 getForKey:Identifier 走 *this 或原名,
MemberExpression 取属性名,其余一律 warning + 返回空串)。

所以这批告警不只是文案问题:产物里对应的 <block wx:for> 后面确实没有
wx:key,列表项因此失去复用标识,增删时会整段重建节点。本次按编译器
接受的写法逐一改正,共 13 个文件。

改法:
- 纯 URL 字符串数组(打卡/门头/小票/凭证/巡店照片)直接用元素自身
  :key="img",编译为 wx:key="*this"
- 对象数组用其已有唯一字段:连锁/门店 item.id、抄送用户 user.id、
  审计销量行 detail.key、编辑销量项 detail._key
- 本身无唯一字段的巡店列表补 _key:task/detail 沿用 visit.vue 已验证的
  _rowKey(自增 seed,增删稳定),records 与 AuditVisitReportItem 用序号

sales.vue 另有一处隐蔽问题:row 是 {item, index} 包装对象,
:key="row.item._key || row.index" 即便写成简单形式也会生成 wx:key="_key",
在 row 上取不到值。改为在 visibleSalesItems 里把 key 提到包装对象顶层,
_key 缺失时用序号兜底。create.vue 的销量摘要同样补 __key 兜底,避免重复 key。

注:task/detail 的 storeList 提交走 sanitizeStoreList() 显式白名单,
_rowKey 不会外泄到后端。

验证:HBuilderX cli 重新编译 —— 编译成功,非 h5 平台 :key 告警 0 条
(修改前满屏 40+ 条),产物中 wx:for 与 wx:key 数量逐文件相等。
This commit is contained in:
2026-10-12 18:18:11 +08:00
parent e192296ea7
commit 40fed38f83
13 changed files with 58 additions and 41 deletions
+4 -2
View File
@@ -46,7 +46,7 @@
</view>
<view v-else class="sp-list">
<view class="sp-card" v-for="row in visibleSalesItems" :key="row.item._key || row.index">
<view class="sp-card" v-for="row in visibleSalesItems" :key="row.key">
<view class="sp-badge">{{ formatBadge(row.index) }}</view>
<image v-if="row.item.cover" :src="row.item.cover" mode="aspectFill" class="sp-cover"/>
<view v-else class="sp-cover sp-cover-empty">
@@ -261,7 +261,9 @@ export default {
const keyword = (this.keyword || '').trim().toLowerCase()
const cate = this.filterCate
return (Array.isArray(this.salesItems) ? this.salesItems : [])
.map((item, index) => ({item, index}))
// wx:key 只认 item 上的属性名,表达式会被编译丢弃;
// 这里把 key 提到包装对象顶层,_key 缺失时用序号兜底保证唯一
.map((item, index) => ({item, index, key: (item && item._key) || `sales_row_${index}`}))
.filter(row => {
if (cate && String(row.item.groupTitle || '') !== cate) return false
if (!keyword) return true