承接第五篇库存、订单、优惠券跨同步复盘，本篇聚焦自提核销、售后退款、云定时任务、用户端页面交互类前后端联动故障，全部来自线下门店真机实测，逐条还原故障现象、根因与落地修复方案，本地零售小程序开发者可直接参考避坑。

一、核销 / 退款 / 定时联动模块优化整体落地效果

统一打通线上自提核销全链路、多级售后退款流转、定时任务两端同步逻辑；修复 C 端页面布局、评价缓存、发票状态、图片加载等联动问题。 优化后自提码生成、门店核验数据互通；超时关单、自动确认收货、优惠券过期等定时任务执行后，C 端订单、优惠券状态实时更新；退款申请、审核驳回两端状态统一，全链路消除数据不同步问题。

二、自提核销 / 退款 / 定时 / 交互联动踩坑逐项复盘

1. 自提订单 C 端、后台无核销码

问题具体现象 用户下单选择自提并支付完成，订单页面不展示 6 位核销码，后台核销页面无法检索订单，线下核验流程断裂。

排查与修复过程 create_order云函数仅为配送单生成凭证，缺失自提码生成入库逻辑。

优化方案：下单时区分履约类型，自提单自动生成 6 位核销码存入订单表，两端页面同步读取展示。

2. 配送订单完成无收货拍照留存入口

问题具体现象 后台将配送订单标记送达时，无照片上传功能，售后纠纷缺少收货凭证，仅自提单存在核销记录。

排查与修复过程 updateStatus状态更新函数未配套配送拍照上传分支逻辑。

优化方案：配送单标记完成时弹出拍照弹窗，凭证关联订单永久存档，订单详情可查看。

3. 结算后购物车已选商品未自动清空

问题具体现象 购物车勾选商品提交订单支付成功，返回购物车仍保留已结算条目，易造成重复下单。

排查与修复过程 下单成功流程未批量删除对应购物车数据。

优化方案：新增clearCheckedCartItems方法，下单成功根据 cartId 批量删除选中商品，同步更新购物车角标。

4. 购物车底部结算栏真机被遮挡

问题具体现象 模拟器布局正常，手机真机底部金额、结算按钮被商品列表遮盖，无法操作下单。

排查与修复过程 滚动容器未预留底部安全边距，真机底部导航高度适配缺失。

优化方案：调整列表容器高度，预留结算栏安全区域，保证按钮全程可见。

5. 个人中心客服电话不读取后台门店配置

问题具体现象 后台修改门店联系电话，前端联系客服依旧读取代码默认号码，配置不生效。

排查与修复过程 个人中心未调用get_store_config拉取门店联系方式。

优化方案：页面加载同步读取后台配置，无号码时展示 “暂无联系方式”。

6. 领券中心领取记录不在我的优惠券展示

问题具体现象 用户成功领券后，我的优惠券列表无对应记录，后台可查到发放数据。

排查与修复过程 测试阶段删除优惠券模板，前端过滤逻辑误隐藏有效领取记录。

优化方案：调整优惠券过滤规则，仅剔除过期、已核销券，保留用户历史领取凭证。

7. 全端时间统一携带 TZ 时区，展示不友好

问题具体现象 订单、优惠券、评价所有页面时间携带原始 TZ 字符串，普通用户难以识别。

排查与修复过程 C 端未统一封装全局时间格式化工具。

优化方案：全部页面加载时统一去除时区标识，转换为标准YYYY-MM-DD HH:mm格式。

8. 结算金额小数位数杂乱，存在多位尾零

问题具体现象 商品价、配送费、实付金额偶尔出现三位以上小数，金额展示不规范。

排查与修复过程 费用计算未统一做两位小数强制格式化。

优化方案：所有金额计算后调用toFixed(2)统一规范展示。

9. 首页 / 购物车 / 订单列表无下拉刷新

问题具体现象 用户完成下单、领券后，必须重进页面才能刷新数据，无主动同步入口。

排查与修复过程 页面未开启下拉刷新配置，无onPullDownRefresh重载逻辑。

优化方案：页面 json 开启下拉刷新，新增重载方法，刷新完成给出提示。

10. 多商品订单切换评价丢失填写内容

问题具体现象 多规格订单切换评价 Tab，已填写文字、图片全部清空，需要重复录入。

排查与修复过程 切换商品无临时缓存评价的逻辑。

优化方案：新增reviews缓存对象，切换前后自动保存、恢复评价内容，全部填写后统一提交。

11. 订单全部评价完成仍显示 “去评价” 按钮

问题具体现象 订单内所有商品评价完毕，订单列表、详情依旧展示评价入口，无状态区分。

排查与修复过程 页面未统计订单已评价商品总数，缺少状态判断分支。

优化方案：对比商品总数与已评价数量，全部完成后切换为 “查看评价” 按钮。

12. 体验版小程序图片全部无法加载

问题具体现象 开发、体验环境商品图片空白，正式上架后图片正常显示。

排查与修复过程 微信云存储免费额度限制，体验环境无资源访问权限。

优化方案：上线前扩容云存储，体验版增加图片加载失败友好提示。

13. 配送完成订单无评价入口

问题具体现象 门店核销自提单可评价，商家标记送达的配送订单无评价按钮。

排查与修复过程 评价展示条件仅匹配自提完成状态，未加入配送完成分支。

优化方案：配送、自提两类履约完成订单统一开放评价入口。

14. 发票申请驳回后依旧显示申请按钮

问题具体现象 商家驳回开票申请后，订单页面仍展示申请入口，可重复提交单据。

排查与修复过程 页面判断条件未区分驳回rejected状态。

优化方案：驳回状态切换按钮文字为 “重新申请发票”。

15. 订单商品卡片无法跳转详情

问题具体现象 点击订单内商品名称、卡片无跳转，复购需要重新搜索商品。

排查与修复过程 商品条目未绑定goToProductDetail点击跳转事件。

优化方案：商品卡片绑定点击事件，携带商品 ID 跳转详情页。

16. 首页 / 分类 / 搜索秒杀商品原价未隐藏

问题具体现象 秒杀商品同时展示划线原价与活动价，页面视觉杂乱。

排查与修复过程 商品卡片无秒杀状态价格区分逻辑。

优化方案：参与秒杀商品仅高亮展示红色活动价，弱化原价展示。

17. 秒杀倒计时不拆分天时分秒

问题具体现象 长周期秒杀仅合并计算小时，无法直观展示剩余天数。

排查与修复过程 startSeckillCountdown工具函数无天数拆分逻辑。

优化方案：重构倒计时计算逻辑，分段展示天、时、分、秒。

18. 优惠券标签样式不统一

问题具体现象 领券中心满减、有效期标签配色、圆角样式割裂，观感混乱。

排查与修复过程 多套独立 CSS 标签样式，无统一公共类。

优化方案：统一优惠券标签公共样式，视觉保持一致。

19. 首页秒杀价格无红色高亮区分

问题具体现象 首页秒杀商品字体与普通商品无差异，优惠辨识度低。

排查与修复过程 未给秒杀价格配置专属醒目样式。

优化方案：新增红色价格 CSS 类，秒杀商品统一高亮展示。

20. 退款取消订单优惠券未返还用户

问题具体现象 未核销订单全额退款后，优惠券未退回用户优惠券包。

排查与修复过程 退款、取消订单流程无优惠券恢复逻辑。

优化方案：退款成功自动返还未过期优惠券，过期券不予退回。

21. 定时自动关单前端状态不刷新

问题具体现象 30 分钟未支付订单定时关闭，用户停留在小程序时订单依旧显示待支付。

排查与修复过程 定时任务仅修改后端数据，前端无实时同步机制。

优化方案：订单页面每次onShow重新拉取最新订单状态。

22. 定时自动确认收货不展示评价入口

问题具体现象 订单满七天系统自动确认收货，页面不刷新评价按钮。

排查与修复过程 页面加载未校验定时变更后的订单完成状态。

优化方案：每次进入订单页重新校验履约状态，自动展示评价入口。

23. 用户设置页面消息通知模块冗余

问题具体现象 设置页预留消息通知开关，但整套系统无推送配套功能，属于无效入口。

排查与修复过程 前期规划遗留页面模块，后续未开发对应功能。

优化方案：注释隐藏消息通知相关页面代码。

24. 后台过期公告前端首页仍展示

问题具体现象 公告设置自动下架时效，到期后台停用，但首页跑马灯继续展示过期通知。

 排查与修复过程 首页拉取公告未做过期、停用双重过滤。

优化方案：首页加载时过滤过期、停用公告，仅展示有效通知。

三、本篇小结

本篇收录项目剩余全部前后端联动故障，覆盖自提核销线下履约、多级售后退款、云定时自动任务、C 端页面布局、评价缓存、发票全流程、图片环境兼容等全场景问题。 本地商超小程序线上线下链路交织，定时任务、线下核销、售后退款极易产生两端数据割裂；核心解决思路统一：所有定时、售后、核销操作同步更新两端数据表，用户页面每次激活重载业务数据，页面缓存仅做视觉兜底，不作为数据唯一来源。

连载目录回顾

第一篇：B 端商家后台完整产品设计思路

第二篇：C 端用户端完整产品设计思路

第三篇：小程序后台实拍图 & 业务流程逻辑图汇总

第四篇：后台开发踩坑复盘（商品、营销、权限配置类 Bug）

第五篇：用户端 & 后台联动踩坑上篇（库存、支付、订单同步问题）

本篇：用户端 & 后台联动踩坑下篇（自提核销、退款、定时任务异常）

第七篇： PC 管理端 Demo 完整开发成果展示

第八篇：本地商超小程序全项目开发历程完整复盘总结

下一篇将完整展示 PC 管理端 Demo 全部页面、整体开发成果与功能架构。