回音项目实战：取消订单未返还库存与总库存显示异常的排查与修复

本文将记录并分析在“回音”项目中遇到的两个核心库存问题：取消订单后库存未正确返还，以及库存管理中总库存数量显示异常。通过逐步排查与修复，为处理类似业务逻辑问题提供参考。

一、接口问题排查

1. 取消订单后库存未返还问题

问题描述：客户反馈，在系统中取消订单后，对应的商品库存没有自动增加（即未返还至库存）。

分析与排查：经本地测试，库存返还功能原本正常，因此需要排查线上环境的具体原因。

解决步骤：

第一步：定位原因 直接测试确认取消订单后库存未返还。经代码审查发现，问题根源在于订单明细批次表 fa_order_detail_product_pici 未能成功写入返还记录。

进一步排查发现，写入逻辑中有一个条件限制：仅当 $count > 0 时才执行写入操作。然而在取消订单的场景下，需要操作的库存数量（返还）本身就是正值，此逻辑无误。但深究发现，问题的核心是在库存扣减为0时应停止操作的判断逻辑有误，修正了相关的条件判断。

图：针对库存返还逻辑的代码调整示意

第二步：测试验证 修复代码后，在测试环境中验证，取消订单功能恢复正常，库存可正确返还。

2. 库存管理总库存显示为0

问题描述：库存管理页面中，部分商品的总库存数量显示为0，但与实际批次库存情况不符。

分析与排查：在数据核查中，发现了矛盾的现象：某些商品的单个批次库存数量小于总库存，或者批次库存有具体数值，但汇总的总库存却显示为0。

图：批次库存与总库存数据不一致的异常情况

解决步骤： 此问题通常涉及数据聚合计算逻辑或缓存机制。在复杂的库存管理中，确保数据库/中间件层面数据的一致性至关重要。需要核对计算总库存的SQL语句或业务逻辑代码，检查是否存在条件过滤错误、连接查询错误或数据同步延迟。同时，检查是否因为缓存未及时更新导致了视图数据显示异常。

第一步：核查计算逻辑 检查负责汇总各批次库存以计算总库存的代码段。重点排查GROUP BY语句、SUM函数的使用条件，以及关联查询时是否因为LEFT JOIN导致数据丢失。

第二步：验证与测试 修复计算逻辑后，需对多种库存场景（正常入库、部分出库、全出库再入库）进行测试，确保总库存能实时、准确地随批次库存变动而更新。

二、WordPress 页面开发任务

1. 手表产品展示页面开发

任务描述：基于客户提供的参考网站，在现有WordPress站点中开发一个全新的手表产品展示页面。

技术选型：计划使用前端组件库提高开发效率与一致性。

实施步骤：

第一步：本地环境搭建

• 下载项目源代码 (15:28 – 15:48)。
• 获取生产环境数据库备份 (15:40 – 15:50)。
• 在本地成功部署并运行站点，确保基础环境正常 (15:52 – 16:02)。

第二步：数据库导入与调整 将备份的数据库导入本地环境 (16:03 – 16:23)。导入后，对时间显示格式进行了调整，使其更符合本地需求。

图：调整数据库时间显示格式

第三步：前端页面开发 由于页面需要较高的交互性与美观度，决定采用Element UI这类成熟的前端框架/工程化组件库来构建手表展示页面。这样可以快速搭建出结构清晰、风格统一的栅格布局、卡片和模态框等组件，专注于产品数据和展示逻辑的开发。

四、昨日花销记录

（此部分为个人记录，保留原始格式）

1.盒马生鲜鱿鱼19 炸鸡桶40 饮料41 日计100  月计1288  平均1288/7=184 25-12-7 17:17 来自北京
2.翡翠书院给大宝买零食13          日计113  月计1301  平均1301/7=185 25-12-7 17:21 来自北京
3.摩托车加油38                  日计151 月计1339  平均1339/7=191 25-12-7 17:22 来自北京