Parcourir la source

fix(eds): 解析失败原因持久化到 file_info.remark

- 解析失败时同步写 fileStatus=FILE_EDS_FAIL 与 remark,避免离开上传页清空进度表后原因丢失
- getFiles 组装备注时优先取进度表实时原因,取不到回落到 remark
- file_info 新增 remark 列;老案件库开案时通过 FILE_INFO_MIGRATIONS 幂等补列
- 同步更新 sql/case_table_1.sql 建表语句
cc il y a 2 semaines
Parent
commit
48f9fa976a

+ 28 - 0
ai-server/src/main/java/com/zsjz/ai/common/datasource/CaseDataSourceRegistry.java

@@ -121,6 +121,7 @@ public class CaseDataSourceRegistry {
                 "jdbc:duckdb:" + dbFile, "org.duckdb.DuckDBDriver", memoryMiB, threads);
         routingDataSource.addDataSource(physicalKey(caseId), dataSource);
         ensureAiProfileTable(caseId, dataSource);
+        ensureFileInfoColumns(caseId, dataSource);
         opened.put(caseId, new OpenedCase(dataSource, ownerUserId, ownerToken, System.currentTimeMillis()));
         log.info("案件数据源已打开: caseId={}, key={}, dbPath={}, memoryLimit={}MiB, threads={}",
                 caseId, physicalKey(caseId), dbPath, memoryMiB, threads);
@@ -156,6 +157,22 @@ public class CaseDataSourceRegistry {
         }
     }
 
+    /**
+     * 给 {@code file_info} 补后加的列(老案件库与模板库复制出的新库都在开案时补齐)。
+     *
+     * <p>失败不阻断开案:与 {@link #ensureAiProfileTable} 同口径,只影响对应功能的展示。</p>
+     */
+    private void ensureFileInfoColumns(Long caseId, DuckdbUnpooledDataSource dataSource) {
+        try (Connection conn = dataSource.getConnection();
+             Statement st = conn.createStatement()) {
+            for (String migration : FILE_INFO_MIGRATIONS) {
+                st.execute(migration);
+            }
+        } catch (Exception e) {
+            log.error("补齐 file_info 列失败(不影响开案,电子数据包失败原因可能无法展示): caseId={}", caseId, e);
+        }
+    }
+
     /**
      * {@code file_ai_profile} 建表语句,与 {@code sql/case_table_1.sql} 保持一致。
      *
@@ -200,6 +217,17 @@ public class CaseDataSourceRegistry {
             "ALTER TABLE file_ai_profile ADD COLUMN IF NOT EXISTS caseId BIGINT"
     );
 
+    /**
+     * 给已存在的 {@code file_info} 补列(见 {@link #ensureFileInfoColumns})。
+     *
+     * <p>每句都必须可重复执行:DuckDB 的 {@code ADD COLUMN IF NOT EXISTS} 满足,
+     * 否则第二次开案会抛「Duplicate column name」,整串补列都会中断。</p>
+     */
+    static final List<String> FILE_INFO_MIGRATIONS = List.of(
+            // 2026-11-04:电子数据包解析失败原因。进度表离开上传页即清空,失败原因必须落到文件行
+            "ALTER TABLE file_info ADD COLUMN IF NOT EXISTS remark VARCHAR"
+    );
+
     /**
      * 导出案件库的一份<b>独立单文件快照</b>(供 Python 子进程只读打开)。
      *

+ 9 - 0
ai-server/src/main/java/com/zsjz/ai/common/model/dm/entity/FileInfo.java

@@ -179,6 +179,15 @@ public class FileInfo implements Serializable {
     @TableField(exist = false)
     private Integer mainId;
 
+    /**
+     * 备注(持久化):目前用于电子数据包解析失败原因。
+     *
+     * <p>失败原因不能只写进度表 {@code eds_material_process}:离开上传页时进度表会被清空,
+     * 导入文件列表的「备注」需要长期可读,因此解析失败时同时落到这里。</p>
+     */
+    @TableField("remark")
+    private String remark;
+
     /**
      * 清洗方式(仅 sheet 记录有意义,由 getFiles 组装时按 AI 任务记录回填):
      * 「AI清洗」= 经 AI 判定后入库(含 AI 命中既有模板与 AI 新建表);

+ 4 - 2
ai-server/src/main/java/com/zsjz/ai/module/dm/service/DmService.java

@@ -1100,13 +1100,15 @@ public class DmService {
             }
             if (FileTypeConstants.EDS_PACKAGE.equalsIgnoreCase(fileInfo.getFileType())) {
                 EdsMaterialProcess process = edsLookup.byId().get(fileInfo.getId());
-                fileInfo.setCleanNote(process == null ? null : process.getErrorMessage());
+                // 进度表在离开上传页时会被清空:实时原因取不到就回落到文件行上持久化的 remark
+                String liveReason = process == null ? null : process.getErrorMessage();
+                fileInfo.setCleanNote(StrUtil.blankToDefault(liveReason, fileInfo.getRemark()));
             } else if (StrUtil.isNotBlank(fileInfo.getFilePath())) {
                 EdsMaterialProcess legacy = edsLookup.byPath().get(fileInfo.getFilePath());
                 if (legacy != null) {
                     // 旧数据:数据包记录是 fileType=1,按路径识别后统一按电子数据包口径展示
                     fileInfo.setFileType(FileTypeConstants.EDS_PACKAGE);
-                    fileInfo.setCleanNote(legacy.getErrorMessage());
+                    fileInfo.setCleanNote(StrUtil.blankToDefault(legacy.getErrorMessage(), fileInfo.getRemark()));
                 }
             }
             List<FileInfo> childrens = fileMap.getOrDefault(fileInfo.getId(), List.of());

+ 14 - 7
ai-server/src/main/java/com/zsjz/ai/module/eds/service/EdsMaterialProcessService.java

@@ -238,7 +238,10 @@ public class EdsMaterialProcessService {
     }
 
     /**
-     * 解析失败收口:进度记录与 file_info 都标记失败(file_info 供导入文件列表展示错误)。
+     * 解析失败收口:进度记录与 file_info 都标记失败,并把失败原因写入 file_info.remark。
+     *
+     * <p>进度表在离开上传页时会被 {@link #clearProcesses()} 清空,失败原因只留在进度表里
+     * 会导致导入文件列表的「备注」变空,所以这里同步落一份到文件行。</p>
      */
     private void markParseFailed(Long fileId, String message) {
         try {
@@ -246,7 +249,7 @@ public class EdsMaterialProcessService {
         } catch (Exception e) {
             log.error("回写电子数据包解析失败状态失败: id={}", fileId, e);
         }
-        updateFileInfoStatus(fileId, FileSheetStateEnum.FILE_EDS_FAIL);
+        updateFileInfoFailed(fileId, message);
     }
 
     /**
@@ -297,17 +300,21 @@ public class EdsMaterialProcessService {
     }
 
     /**
-     * 回写电子数据包 file_info 状态(成功由 {@code EdsExtra.finish} 回写,这里只处理失败)。
+     * 回写电子数据包 file_info 失败状态与备注(成功由 {@code EdsExtra.finish} 回写)。
+     *
+     * <p>备注写 {@code remark} 列而不是瞬态的 {@code FileInfo.cleanNote}:
+     * 导入文件列表重新查库时才能拿到失败原因。</p>
      */
-    private void updateFileInfoStatus(Long fileId, FileSheetStateEnum status) {
+    private void updateFileInfoFailed(Long fileId, String message) {
         try {
             FileInfo update = new FileInfo();
             update.setId(fileId);
-            update.setFileStatus(status);
+            update.setFileStatus(FileSheetStateEnum.FILE_EDS_FAIL);
+            update.setRemark(message);
             fileInfoMapper.updateById(update);
         } catch (Exception e) {
-            log.info("回写电子数据包 file_info 状态失败: fileId={}, status={}, err={}",
-                    fileId, status, e.getMessage());
+            log.info("回写电子数据包 file_info 失败状态失败: fileId={}, err={}",
+                    fileId, e.getMessage());
         }
     }
 

+ 2 - 0
sql/case_table_1.sql

@@ -26,6 +26,8 @@ CREATE TABLE file_info
     failNum        INTEGER   DEFAULT 0 NOT NULL,
     fileStatus     VARCHAR,
     md5            VARCHAR,
+    -- 备注(持久化):电子数据包解析失败原因等。老案件库由开案时的 FILE_INFO_MIGRATIONS 补列
+    remark         VARCHAR,
     createDateTime TIMESTAMP DEFAULT CURRENT_TIMESTAMP
 );