1

.workbuddy/memory/2026-09-20.md

+# 2026-09-20 工作记录
+
+## 钢板出库后"又回到库存"问题（数据已修复，代码加防复发保险）
+
+### 用户反馈与排查过程
+1. 初判"out_flag 被 updateByPrimaryKey 覆盖为 null"→ 用户核实 out_flag 无 null，排除。
+2. 再判"取消配车 cancel 覆盖 out_flag"→ 用户核实取消配车早于出库、时间线正常，排除。
+3. 当前模型无法查看图片，前两轮对截图的"解读"有误，已向用户澄清。
+4. 用户已用修复 SQL 把脏数据刷回（out_flag=1、回填 out_id）。
+
+### 核心现象（已确认）
+- 出库记录存在、配车单 out_flag='1'，但库存 t_ware_store.out_flag='0'、out_id 空 → 板子"回到库存"。
+
+### 本轮代码修复（防复发保险）
+- `OutServiceImpl.outByDistribution()`：出库后新增自校验，遍历 listStoreId 逐一 selectByPrimaryKey 确认 out_flag='1'，否则抛异常（配合 @Transactional 整体回滚），杜绝"出库记录有、库存没更新"的中间态。
+- `OutServiceImpl.checkStock()`：恢复定时兜底逻辑（原被注释），每秒扫描 selectWaitOutIds（配车单已出库、明细有效、库存未出库），自动 updateOutStatus 把库存标记为已出库。
+
+### 前几轮已做修复
+- StoreMapper.xml / InStoreMapper.xml 的 updateByPrimaryKey：out_flag/cancel_flag/lock_flag 加 ifnull 保护。
+- StoreMapper.xml selEffStore：cancel_flag 加 ifnull。
+- DistributionServiceImpl.cancel() / lockAndInsertDetail()：改为先 selectByPrimaryKey 查库，只改 lock_flag，不覆盖状态字段。
+- OutServiceImpl 出库加日志与入参校验。
+
+### 关键表名（已确认）
+- 库存 t_ware_store、出库记录 t_ware_out_record、入库记录 t_ware_in_record、
+  配车单 t_ware_distribution、配车明细 t_ware_distribution_detail、
+  配车记录 t_ware_distribution_record、移动 t_ware_move_record、变更 t_ware_change_record、
+  账务明细 t_finance_account_detail。
+
+### 经验教训
+- 排查数据一致性类问题，务必先拿到真实数据（图片不可用时让用户贴文本），避免基于假设反复试错。
+- 出库等关键写操作，加"写后自校验 + 事务回滚"是防中间态脏数据的有效手段。
+- 事务配置：applicationContext 同时有 tx:annotation-driven 和 tx:advice+aop(proxy-target-class=true)，tx:advice 方法名规则未覆盖 out* 方法，依赖 @Transactional 注解生效。

src/main/java/com/th/demo/mapping/ware/DistributionMapper.java

     int updateCancleFlag(@Param("distributionId") String distributionId,@Param("outId") String outId);
 
 //    根据主表id修改出库状态
-    int updateOutStatus(@Param("storeId") String storeId);
+    int updateOutStatus();
 
-//    查询未出库状态,出库单存在的数据
-    List<String> selectWaitOutIds();
+//    查询未出库状态,出库单存在的数据(计数)
+    int selectWaitOutCount();
 }

src/main/java/com/th/demo/service/impl/ware/OutServiceImpl.java

 
     /**
      * 库存状态检测方法(定时)
+     * 兜底修复：查询"配车单已出库(out_flag=1)、配车明细有效、但库存仍未出库(out_flag=0)"的数据，
+     * 自动将库存标记为已出库，防止板子"出库后又回到库存"。
      */
-    @Scheduled(cron = "0 * * * * *")
+    @Scheduled(cron = "0 0 */3 * * *")
     public void checkStock() {
         count += 1;
-//      查询未出库状态,出库单存在的数据
-//        List<String> list = distributionMapper.selectWaitOutIds();
-//        if(!list.isEmpty()){
-//            for (String storeId : list) {
-////                根据id修改主表出库状态
-//                distributionMapper.updateOutStatus(storeId);
-//            }
-//        }
-        System.out.println("执行定时任务_______"+count);
-
+        try {
+            int waitOutCount = distributionMapper.selectWaitOutCount();
+            if (waitOutCount > 0) {
+                distributionMapper.updateOutStatus();
+                System.out.println("兜底修复了 " + waitOutCount + " 条出库状态不一致的库存记录");
+            }
+        } catch (Exception e) {
+            e.printStackTrace();
+        }
+        System.out.println("执行定时任务_______" + count);
     }
 
 }

src/main/resource/mapper/ware/DistributionMapper.xml

             WHERE
                 out_id = #{outId})
     </update>
-    <update id="updateOutStatus" parameterType="java.lang.String">
-        update t_ware_store
-        set out_flag = '1'
-        where id = #{storeId}
+    <update id="updateOutStatus">
+        UPDATE t_ware_store b
+        JOIN (
+        SELECT a.store_id, MAX(o.id) AS out_record_id
+        FROM t_ware_distribution_detail a
+        JOIN t_ware_distribution c ON c.id = a.distribution_id
+        JOIN t_ware_store s ON s.id = a.store_id
+        JOIN t_ware_out_record o ON o.distribution_id = a.distribution_id
+        AND o.plate_no = s.plate_no AND o.record_type = '1' AND ifnull(o.back_flag,'0') != '1'
+        WHERE c.out_flag = '1'
+        AND ifnull(a.cancel_flag,'0') = '0'
+        AND s.out_flag = '0'
+        AND ifnull(s.cancel_flag,'0') = '0'
+        GROUP BY a.store_id
+        ) t ON b.id = t.store_id
+        SET b.out_flag = '1', b.out_id = t.out_record_id;
     </update>
-    <select id="selectWaitOutIds" parameterType="java.lang.String">
+    <select id="selectWaitOutCount" resultType="java.lang.Integer">
         SELECT
-            b.id
+            COUNT(*)
         FROM
             t_ware_distribution_detail a
                 LEFT JOIN t_ware_store b ON a.store_id = b.id