gxwebsoft/xinlong-shop-taro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
7a14272fe83a3bac3d8f00c3cd6b90af5ae2c3cf
xinlong-shop-taro/.workbuddy/memory/2026-07-14.md
赵忠林 7a14272fe8 fix(order): 修复订单列表页登录后仍看到别人订单问题 
- 使用 userIdRef 避免闭包过期，确保加载订单时 userId 正确
- loadOrders 函数开头增加硬拦截，没有 userId 则不加载订单
- useEffect 中添加 user?.userId 判断，等待有效 userId 再加载
- useEffect 依赖数组加入 user?.userId，userId 变化时重新加载订单

feat(index): 首页铃铛接入新订单轮询与提示

- 登录后获取店员身份，使用 isClerkRef 避免闭包问题
- 通过 useNewOrderDetector 每30秒轮询门店订单，仅店员有效
- 新订单时触发震动和提示，铃铛数字角标动态显示新订单数
- 铃铛点击区分店员和普通用户，店员跳门店订单页并清除未读
- 页面展示时刷新店员身份，确保身份状态及时更新
2026-07-14 02:05:26 +08:00

12 KiB
Raw Blame History

购物车功能修复（2026-07-14）

问题

购物车页面（pages/shop/cart）商品显示异常：

  • 商品名称/图片/价格信息缺失
  • 加入购物车后无法正确显示

根因

CartContext.refresh() 方法在将后端 API 返回的购物车项映射为前端 CartItem 时，遗漏了 product（商品详情）和 sku（SKU 详情）嵌套对象的映射。导致页面中 item.product?.name/image/price 和 item.sku?.price/image 均为 undefined，UI 只能显示硬编码的默认值。

修改

  1. src/contexts/CartContext.tsx（核心修复）

    • refresh() 的 mappedItems 映射中补充 product 和 sku 字段
    • 使用 (item as any).product / (item as any).sku 获取后端返回的嵌套对象

  2. src/utils/image.ts（增强健壮性）

    • 新增 ensureFullUrl() 辅助函数：相对路径自动补全 OSS 域名 https://oss.wsdns.cn
    • getCompressedImageUrl() 内部调用 ensureFullUrl 确保 URL 完整性

  3. src/pages/shop/cart.tsx（补充图片回退源）

    • 图片 src 回退链增加 (item.sku as any)?.image
    • 完整回退链：goodsImage -> product.image -> sku.image -> ''

收藏列表图片/价格不显示修复（2026-07-14）

问题

pages/user/favorite-list/index 收藏列表：商品图片、价格、名称均空白。

根因

后端 /api/shop/goods/favorite/list（前端 /shop/goods/favorite/list）走 ShopGoodsFavoriteServiceImpl.listRel → selectListRel，SQL 只 SELECT a.* 未关联商品表，返回字段仅 id/userId/goodsId/merchantId/tenantId/createTime，不含商品信息。前端依赖 goodsImage/goodsName/price/salePrice 均为 undefined。

修改（方案1：后端返回商品信息）

  1. 后端 guilixu-java：

    • ShopGoodsFavorite.java：新增 4 个 @TableField(exist=false) 非持久化字段 goodsName(String)、goodsImage(String)、price(BigDecimal)、salePrice(BigDecimal)，并补 BigDecimal/TableField import。
    • ShopGoodsFavoriteMapper.xml 的 selectSql：SELECT a.*, g.name AS goods_name, g.image AS goods_image, g.price AS price, g.sale_price AS sale_price，LEFT JOIN shop_goods g ON a.goods_id = g.goods_id（已确认 map-underscore-to-camel-case: true，别名可映射）。
    • 注意：本机无 maven 无法编译，改动为常规 MyBatis/MP 写法，需用户自行编译部署。

  2. 前端：

    • src/api/shop/shopGoodsFavorite/model.ts：favoriteId 改为 id（后端实际返回 id）；新增 price?: string|number；salePrice 改为 string|number。
    • pages/user/favorite-list/index.tsx：图片用 item.goodsImage；价格改为优先 item.price（到手价），salePrice 作为划线价（salePrice > price 时显示）；key 改用 item.id ?? item.goodsId（原 favoriteId 始终 undefined 会导致 key 重复）。
    • 注：src/pages/favorite-list.tsx 为未注册路由的重复文件，未改动。

遗留（非本次范围，供参考）

adapter /list 接口忽略分页，一次返回全部收藏；前端 listShopGoodsFavorite({page,limit:20}) 的无限滚动在收藏>20条时会重复追加。如需彻底解决建议改前端走 /page 接口或后端 /list 支持分页。

购物车更新 API 请求方式修复（2026-07-14）

问题

PUT /api/shop/shop-cart/{id} 返回 HttpRequestMethodNotSupportedException: Request method 'PUT' not supported。

根因

src/api/shop/shopCart/index.ts 中 3 个函数用了非标准 URL 模式 PUT /shop/shop-cart/{id}，而项目所有其他 API（shopOrder、shopArticle 等）的更新操作统一走 PUT /shop/shop-cart（基础 URL，id 放 body）。

修改

  1. updateCartNum：PUT /shop/shop-cart/{id} + {quantity} → PUT /shop/shop-cart + {id, num}
  2. updateCartChecked：PUT /shop/shop-cart/{id} + {selected} → PUT /shop/shop-cart + {id, checked}（同时修正字段名 selected→checked 与 model 一致）
  3. updateCartAllChecked：PUT /shop/shop-cart/selected + {selected} → POST /shop/shop-cart/selected + {checked}（改用 POST，自定义批量操作更可能支持 POST；CartContext 已有静默 catch 兜底）

购物车后端 SQL 关联查询修复（2026-07-14）

问题

GET /api/shop/shop-cart 返回的数据没有商品图片、价格等信息。前端 CartContext.refresh() 已映射 goodsName/goodsImage/skuPrice/skuSpec/stock 等字段，但后端根本没返回这些字段。

根因

后端 ShopCartMapper.xml 的 SQL 只做 SELECT a.* FROM shop_cart a，没有 JOIN 商品表和 SKU 表。

后端修改（guilixu-java 项目）

  1. ShopCart.java：新增 7 个 @TableField(exist = false) 非持久化字段：goodsName、goodsImage、skuPrice、skuSpec、stock、salePrice、dealerPrice；补充 TableField import
  2. ShopCartMapper.xml：SQL 改为 LEFT JOIN shop_goods g ON a.goods_id = g.goods_id + LEFT JOIN shop_goods_sku s ON a.sku_id = s.id，SELECT 别名映射到新字段（COALESCE(s.price, g.price) AS sku_price、COALESCE(s.stock, g.stock) AS stock）；同时修复 userId/goodsId/merchantId 从 LIKE 改为 =（原 LIKE 会导致 userId=1 匹配到 10/11/21 等）
  3. ShopCartController.java：list() 方法自动按当前登录用户过滤（param.setUserId(loginUser.getUserId().longValue())）

前端修改

  1. src/api/shop/shopCart/model/index.ts：ShopCart 接口新增 salePrice、dealerPrice 字段
  2. src/contexts/CartContext.tsx：CartItem 新增 salePrice、dealerPrice；refresh() 映射这两个字段；calcPrice() VIP 优先用扁平 i.dealerPrice（之前只看 i.product?.dealerPrice）
  3. src/pages/shop/cart.tsx + src/pages/shop/checkout.tsx：价格显示逻辑同步更新，优先使用扁平 item.dealerPrice / item.salePrice

购物车前后端字段名对齐修复（2026-07-14）

问题

修改购物车数量时后端报 UPDATE shop_cart WHERE id=?（SET 子句为空），MyBatis-Plus 找不到要更新的字段。

根因

前后端字段名不匹配：

  • 前端发送 num，后端实体字段是 cartNum → Jackson 反序列化时 cartNum 为 null → 空 UPDATE
  • 前端发送 checked，后端实体字段是 selected → 同样不匹配
  • 列表返回 cartNum，前端读 item.num → 数量永远为默认值 1

修改文件

  1. src/api/shop/shopCart/model/index.ts：ShopCart.num → cartNum；新增 selected 字段；AddToCartParam.num → cartNum；UpdateCartNumParam.num → cartNum
  2. src/api/shop/shopCart/index.ts：updateCartNum 发 {id, cartNum}；updateCartChecked 发 {id, selected}
  3. src/contexts/CartContext.tsx：refresh() 读 item.cartNum 和 item.selected；addItem() 发 cartNum；updateQuantity 调用 {id, cartNum}
  4. src/pages/shop/index.tsx + src/pages/shop/category.tsx：addToCart 参数 num → cartNum

禁用 loginByOpenId 静默登录（2026-07-14）

改动

  • src/contexts/UserContext.tsx：移除"情况3"静默登录块（Taro.login + loginByOpenId），无 token 时直接保持未登录状态；清理 loginByOpenId、TenantId 无用导入
  • src/hooks/useUser.ts：移除降级方案中的 loginByOpenId 调用，仅从 storage 读取；清理 loginByOpenId、TenantId 无用导入
  • src/api/layout/index.ts 中 loginByOpenId 函数定义保留，仅不再被调用

商城分类页价格登录可见（2026-07-14）

改动

  • src/pages/shop/index.tsx：价格显示从手写 Text 改为 Price 组件 + loginMask 属性（与首页一致），游客看到"登录后查看价格"；VIP 划线价逻辑保留在 original prop 中；单位 unitName 仅登录后显示

订单列表页未登录可查看订单 Bug 修复（2026-07-14）

问题

pages/order/list 未登录用户也能看到订单数据。

根因

页面缺少登录校验——useEffect 直接调用 loadOrders，未登录时 user?.userId 为 undefined，后端未按用户过滤直接返回了订单。

修改

  • src/pages/order/list.tsx：
    1. 从 useUser() 获取 isLoggedIn
    2. useEffect 中未登录时调用 requireLogin({ action: 'viewOrder', redirect: '/pages/order/list', content: '登录后才能查看订单，是否前往登录？' }) 弹窗引导，而不是直接跳转
    3. render 中 if (!isLoggedIn) return null 兜底，避免未登录时渲染订单内容
  • src/passport/login.tsx：登录成功后的 tabBarUrls 白名单补全 pages/order/list，确保从订单入口登录后能 switchTab 回订单页

我的页面未登录可点击需登录功能 Bug 修复（2026-07-14）

问题

pages/user/user 未登录时，点击「我的订单」下的按钮（待付款/待发货/待收货/已完成）、「全部订单」、以及菜单中的「升级VIP会员」「我的钱包」「收货地址」「我的收藏」都能直接跳转页面。

修改

  • src/pages/user/user.tsx：
    1. 导入 requireLogin from @/utils/login-guard
    2. 给需要登录的菜单项加 requireAuth: true 标记（升级VIP会员/门店中心/我的钱包/收货地址/我的收藏）
    3. 新增 handleMenuClick(item)：requireAuth 项调用 requireLogin 弹窗拦截，已登录才 navigateTo
    4. 新增 handleOrderTabClick(status) 和 handleViewAllOrders()：订单入口 requireLogin 拦截，并加 redirect: '/pages/order/list' 让登录后回跳订单页
    5. 未登录时需登录的菜单项和订单按钮加 opacity-50 视觉降级
    6. 「帮助中心」「设置」不需要登录，保持原样

订单列表页登录后仍看到别人订单 Bug 修复（2026-07-14）

问题

pages/order/list 刚登录成功后仍能看到别人的订单，刷新重进后才正常。

根因

loadOrders 的 useCallback 依赖数组为 [updateTabState]，未包含 user，导致闭包过期——登录后 isLoggedIn 变 true 触发 effect 调用 loadOrders，但闭包中的 user 仍是初始渲染时的 null，userId: user?.userId 传了 undefined，后端未按用户过滤返回了全部订单。

修改

  • src/pages/order/list.tsx：
    1. 新增 userIdRef（useRef(user?.userId)），每渲染同步 userIdRef.current = user?.userId，避免闭包过期
    2. loadOrders 开头从 userIdRef.current 取 userId，if (!userId) return 硬拦截——没有当前登录用户 userId 就禁止加载
    3. useEffect 中增加 if (!user?.userId) return 判断，已登录但 userId 还没拿到时等待下次渲染
    4. useEffect 依赖数组加 user?.userId，userId 变化时重新触发加载

首页铃铛接入新订单轮询（2026-07-14）

需求

首页顶部搜索栏右侧铃铛图标，门店店员有新订单时能收到提醒。

改动

  • src/pages/index/index.tsx：
    1. 导入 useNewOrderDetector、getMyClerk、pageShopOrder、useDidShow、useCallback、useRef
    2. 登录后调 getMyClerk() 检测店员身份，存 isClerk state + isClerkRef ref（ref 用于轮询回调中读取最新值，避免闭包过期）
    3. useDidShow 时也刷新店员身份
    4. 接入 useNewOrderDetector：30秒轮询 pageShopOrder({page:1,limit:5})；fetchLatestOrders 内用 isClerkRef.current 网关——非店员直接返回空数组（不建 baseline，无副作用）
    5. 新订单回调：Taro.vibrateShort 震动 + Taro.showToast 提示"您有 N 条新订单"
    6. 铃铛角标从静态红点改为动态：newOrderCount > 0 显示数字角标（>99 显示 99+），=== 0 时显示小圆点
    7. 点击处理：店员 → navigateTo 门店订单页（有新订单时先 clearUnread()）；普通用户 → 通知页

设计要点

  • isClerkRef 解决 hooks 闭包过期问题——fetchLatestOrders 的 useCallback 依赖空数组，但通过 ref 读取最新店员状态
  • 非店员时 fetchLatestOrders 返回 []，hook 内 doCheck 在 list.length === 0 时 return，knownOrderIdsRef 保持 null 不建 baseline；店员身份确认后首次真实请求才建 baseline，不会误报
  • useNewOrderDetector 内部已处理 useDidShow/useDidHide 生命周期，tabBar 页切走自动停轮询