cykj/hzdyjs

0 Fork 0

Files

T

weizhong e79bf5a26c “编译修改”

2025-10-14 16:41:19 +08:00

8.9 KiB

Raw Blame History

🎯 出国申请附件OSS ID映射修复 - 核心问题解决方案

修复日期：2025-10-11
问题类型：MyBatis ResultMap字段映射缺失
紧急程度：🔴 高 - 影响文件下载功能
修复状态：✅ 已完成代码修复，需重启后端生效

🎯 一句话总结

Mapper.xml的ResultMap中缺少OSS ID字段映射，导致下载时提示"OSS ID不存在"。

📋 快速操作指南（3步）

第1步：停止后端 🔴

# IntelliJ IDEA: 点击红色方块按钮完全停止
# 或者命令行：
ps aux | grep ruoyi-admin
kill -9 <PID>

第2步：启动后端 ▶️

# IntelliJ IDEA: 点击绿色三角按钮启动
# 等待启动完成

第3步：测试下载 ✅

出国申请 → 查看详情 → 点击盖章文件下载
期望：文件正常下载（不报"OSS ID不存在"错误）

🔍 问题详情

问题现象

位置：出国申请详情弹窗
操作：点击"出国境登记表盖章文件"的下载按钮
错误：提示"文件OSS ID不存在，无法下载"
之前：已修复过并可正常下载
现在：再次出现此问题

根本原因

Mapper.xml中ResultMap字段映射不完整：

<!-- ❌ 修复前：缺少OSS ID映射 -->
<resultMap type="RsOverseasApplication" id="RsOverseasApplicationResult">
    ...
    <result property="stampedRegistrationFileName" column="stamped_registration_file_name"/>
    <!-- 缺少：stampedFileOssId 映射 -->
    <result property="stampedFileUploadTime" column="stamped_file_upload_time"/>
    ...
</resultMap>

<!-- ✅ 修复后：添加完整映射 -->
<resultMap type="RsOverseasApplication" id="RsOverseasApplicationResult">
    ...
    <result property="stampedRegistrationFileName" column="stamped_registration_file_name"/>
    <result property="stampedFileOssId" column="stamped_file_oss_id"/>
    <result property="stampedFileUploadTime" column="stamped_file_upload_time"/>
    ...
    <!-- 同时添加党籍附件相关映射 -->
    <result property="partyRetentionFilePath" column="party_retention_file_path"/>
    <result property="partyRetentionFileName" column="party_retention_file_name"/>
    <result property="partyRetentionFileOssId" column="party_retention_file_oss_id"/>
    <result property="partyRetentionUploadTime" column="party_retention_upload_time"/>
    <result property="partyRetentionUploadStatus" column="party_retention_upload_status"/>
</resultMap>

为什么会出现问题？

MyBatis映射机制：

SQL查询虽然包含 stamped_file_oss_id 字段
但ResultMap中没有定义 property="stampedFileOssId" 的映射
MyBatis无法将数据库字段值映射到Java对象属性
结果：stampedFileOssId 为 null
下载时检查OSS ID，发现为null → 报错

🔧 修复内容

修改的文件

backend/ruoyi-modules/ruoyi-rs/src/main/resources/mapper/rs/RsOverseasApplicationMapper.xml

添加的映射（第59-66行）

<!-- 盖章文件OSS ID -->
<result property="stampedFileOssId" column="stamped_file_oss_id"/>

<!-- 党籍保留附件完整映射 -->
<result property="partyRetentionFilePath" column="party_retention_file_path"/>
<result property="partyRetentionFileName" column="party_retention_file_name"/>
<result property="partyRetentionFileOssId" column="party_retention_file_oss_id"/>
<result property="partyRetentionUploadTime" column="party_retention_upload_time"/>
<result property="partyRetentionUploadStatus" column="party_retention_upload_status"/>

⚠️ 重要提醒

为什么必须完全重启？

MyBatis工作流程：
应用启动 → 解析Mapper.xml → 构建映射缓存 → 缓存在内存中

修改Mapper.xml后：
- 文件内容已更新 ✅
- 内存缓存未更新 ❌
- 热部署不会重载XML ❌
- 必须完全重启 ✅

❌ 无效的操作

热部署（Hot Reload）
Reload Changed Classes
Update Resources
Build → Rebuild Project

✅ 唯一有效的操作

完全停止 → 重新启动

📊 修复效果对比

修复前（后端返回）

{
  "applicationId": "1844252876543434752",
  "applicantName": "张三",
  "stampedRegistrationFileName": "出国登记表_已盖章.pdf",
  "stampedFileOssId": null,  // ❌ null
  "stampedFileUploadStatus": "uploaded"
}

结果：点击下载 → 提示"OSS ID不存在"

修复后（后端返回）

{
  "applicationId": "1844252876543434752",
  "applicantName": "张三",
  "stampedRegistrationFileName": "出国登记表_已盖章.pdf",
  "stampedFileOssId": "1844252999888777666",  // ✅ 正常
  "stampedFileUploadStatus": "uploaded"
}

结果：点击下载 → 文件正常下载

🔬 验证方法

方法1：浏览器Console检查

// 打开详情弹窗后，在Console输入：
console.log('OSS ID:', detailData.stampedFileOssId);

// 修复前：输出 null
// 修复后：输出 "1844252999888777666"

方法2：Network请求检查

F12 → Network标签
点击"查看详情"
找到详情接口请求（如 /rs/overseasApplication/123456）
查看Response → data → stampedFileOssId
期望值：不为null的数字字符串

方法3：直接测试下载

打开出国申请列表
找到有盖章文件的申请
点击"查看详情"
点击盖章文件下载按钮
期望：文件下载成功

📁 相关文档

操作指南

⚡️【立即执行】重启后端修复OSS_ID问题.md ← 推荐查看
- 详细的操作步骤
- 故障排查方法
- 各种场景的解决方案

技术总结

✅出国申请OSS_ID下载问题修复总结.md
- 完整的技术分析
- MyBatis映射机制说明
- 预防措施和规范

数据库检查

检查OSS_ID数据.sql
- 检查数据库中OSS ID完整性
- 统计附件上传情况
- 提供数据修复SQL

🛡️ 预防类似问题

添加附件字段的完整检查清单

每次添加文件上传相关字段时，必须同步修改：

数据库表 ✓

ALTER TABLE xxx ADD COLUMN file_oss_id BIGINT(20) COMMENT '文件OSS ID';

Java实体类 ✓
```
private Long fileOssId;
```

Mapper.xml ✓ ⚠️ 最容易遗漏

<!-- ResultMap -->
<result property="fileOssId" column="file_oss_id"/>

<!-- SQL查询 -->
SELECT file_oss_id FROM xxx

<!-- Insert -->
<if test="fileOssId != null">file_oss_id,</if>
<if test="fileOssId != null">#{fileOssId},</if>

<!-- Update -->
<if test="fileOssId != null">file_oss_id = #{fileOssId},</if>

前端接口定义 ✓
```
fileOssId?: number | string;
```
前端页面 ✓
- 上传成功回调设置OSS ID
- 详情显示OSS ID
- 下载时传递OSS ID
测试 ✓
- 完全重启后端
- 测试新增/上传
- 测试查询/显示
- 测试下载

🎓 技术要点

MyBatis映射三要素

1. SQL查询 → SELECT column_name
2. ResultMap → <result property="propertyName" column="column_name"/>
3. Java对象 → private Type propertyName;

三者必须完全对应！

命名规范

层次	命名风格	示例
数据库	snake_case	`stamped_file_oss_id`
Java	camelCase	`stampedFileOssId`
SQL别名	snake_case	`oa.stamped_file_oss_id`
ResultMap	column用数据库风格	`column="stamped_file_oss_id"`
ResultMap	property用Java风格	`property="stampedFileOssId"`

📞 如果问题仍未解决

情况A：重启后仍然提示"OSS ID不存在"

排查步骤：

确认后端真的重启了（查看启动日志时间戳）
检查Mapper.xml语法是否正确
查看后端日志是否有MyBatis错误
执行 检查OSS_ID数据.sql 检查数据库

情况B：前端Console仍然显示null