fix(shop): 修复商城商品导出及专区商品分页问题

- 修复专区商品抽屉分页中20/100条/页按键无效,增加动态分页参数支持
- 修复商城商品导出功能无反应问题,调整loading初始值保证导出流程执行
- 支持商品导出携带当前筛选条件,保证导出数据符合筛选结果
- 商品导出增加封面图路径列,导出URL文本方式避免跨域限制
- 优化UserSelectModal手机号码展示,改为优先展示真实号码字段
- 相关组件调整分页及导出事件参数,提升交互准确性与稳定性
This commit is contained in:
2026-08-17 11:34:39 +08:00
parent 3c4e30c227
commit 6556944ffc
5 changed files with 51 additions and 15 deletions
+29
View File
@@ -141,3 +141,32 @@
- 根因:系统 User 实体 `mobile` 是 `@TableField(exist=false)` 的脱敏字段(`getMobile()` 返回 `DesensitizedUtil.mobilePhone(phone)`);`phone` 才是 DB 真实号码,无 `@JsonIgnore`、无全局脱敏 → 接口同时返回 `phone`(真实) 与 `mobile`(脱敏)。
- 改动:`UserSelectModal.vue` 两处展示由 `u.mobile` 改为 `u.phone`(候选行 `u.phone || u.mobile || '-'`;表格列 `dataIndex:'phone'` + `customRender` 回退 `record.mobile`),后端无需改动。
- 部署:重新构建 admin 前端即可。
## 专区商品抽屉分页「20/100 条/页」不可用修复
- 现象:专区商品抽屉右下角切 20/100 条/页不生效,始终只展示 10 条。
- 根因:`src/views/special/zone/index.vue` 中商品表格的 `:pagination` 把 `pageSize: 10` 写死,且 `onChange` 只接收 `page` 参数、未处理 `pageSize`;翻页事件里还误写成 `goodsPage = page`(应 `.value`)。
- 修复:
- 新增 `goodsPageSize = ref(10)`
- `loadGoods` 请求参数 `limit` 改为 `goodsPageSize.value`
- 分页配置改为 `pageSize: goodsPageSize`、`showSizeChanger: true``onChange(page, pageSize)` 同时更新 `goodsPage.value` 与 `goodsPageSize.value` 后调 `loadGoods`。
- 改动文件:`src/views/special/zone/index.vue`。
- 部署:重新构建 admin 前端即可。
## 商城商品导出「完全无反应」修复(/shop/shopGoods 导出功能不可用)
- 现象:/shop/shopGoods 点「导出xls」完全没反应(无下载、无报错提示)。
- 根因:`src/views/shop/shopGoods/index.vue` 第236行 `const loading = ref(true);`,而 `handleExport` 第一行 `if (loading.value) return;`。`loading` 这个变量只有 `handleExport` 自己会改(导出中设 true / 结束或失败设 false),列表加载的 `reload()`(只调 `tableRef.reload`)、`query()`(只加载分类树)从不碰它 → 页面加载后 loading 永远是初始的 `true` → 导出首行被永久拦截、逻辑从未执行。
- 已排除项:按钮 emit、后端 `/shop/shop-goods` 返回 `ApiResult<List<ShopGoods>>`、xlsx@0.18.5 依赖、vite `optimizeDeps.include:['xlsx']` 均正常——不是接口/依赖/打包问题。
- 修复(按用户"修守卫+带筛选导出"):
1. `index.vue` 第236行 `ref(true)` → `ref(false)`loading 恢复成"导出中防重复点击"语义,首击可进入)。
2. 导出携带当前筛选:`search.vue` emit 签名 `(e:'export', where?: ShopGoodsParam)``handleExport` emit('export', where)`index.vue` `handleExport(where?)` 调 `listShopGoods(where || {})`(原 `listShopGoods({})` 导出全部、忽略筛选)。where 来自 search.vue 的 `useSearch<ShopGoodsParam>`,与列表 datasource 用的 where 同源,完全复现筛选。
- 改动文件:`src/views/shop/shopGoods/index.vue`、`src/views/shop/shopGoods/components/search.vue`(共5处小改)。
- 部署:重新构建 admin 前端(npm run dev 热更新或 npm run build)即可,无需后端改动。
- 验证清单:① 进 /shop/shopGoods 点「导出xls」应弹"正在准备导出数据"并下载 xlsx;② 先筛选分类/关键词/状态再导出,xlsx 内容应与筛选结果一致;③ 导出中连点不应重复触发(loading 防重生效)。
## 商城商品导出增加「封面图」路径列(用户改主意:不内嵌图片,只导出路径)
- 背景:用户原想 Excel 内嵌封面图(前端 fetch OSS 图→base64→xlsx !images),但 OSS(oss.wsdns.cn) 与 admin(websoft.top) 跨域,浏览器 fetch 会被 CORS 拦截;且逐张下载会导致导出变慢、xlsx 体积暴涨。用户明确改为「图片导出路径就行了」——即 Excel 里加一列封面图 URL 文本。
- 实现:`src/views/shop/shopGoods/index.vue` 的 `handleExport` 导出列末尾新增「封面图」列,值为 `ensureFullUrl(goods.image)``@/utils/image` 的 ensureFullUrl:相对路径补成 `https://oss.wsdns.cn/...` 完整 URL,已是 http(s) 原样返回)。表头/每行/`!cols` 列数均由 10 增到 11,封面图列宽 wch:50。
- 补 import`import { ensureFullUrl } from '@/utils/image';`(紧接 xlsx 的 import 之后)。
- 改动文件:`src/views/shop/shopGoods/index.vue`handleExport 内共 4 处:import / 表头 / forEach / !cols)。
- 说明:Excel 单元格中是 URL 文本,运营复制/点开即可在浏览器看原图;不是内嵌缩略图。OSS 图片无 CORS 依赖,导出不再受跨域影响。
- 部署:重新构建 admin 前端即可,无需后端改动。