hzdyjs/【操作指南】出国申请附件功能测试.md

【操作指南】出国申请附件功能测试

✅ 修复完成

已完成以下修复：

1. ✅ 后端VO字段补充 - 添加党籍保留附件的5个字段
2. ✅ Mapper XML修复 - 补充SQL查询OSS ID字段（关键修复）
3. ✅ 后端编译成功 - BUILD SUCCESS
4. ✅ 前端TypeScript接口 - 补充对应字段
5. ✅ 下载功能改进 - 参考培训申请实现，使用request工具
6. ✅ 调试日志添加 - 输出详细字段信息

🔴 本次关键修复

问题：Mapper XML的SQL查询中缺少 stamped_file_oss_id 和 party_retention_file_oss_id 字段
影响：导致API返回的OSS ID始终为null，下载功能提示"文件OSS ID不存在"
修复：已在 RsOverseasApplicationMapper.xml 中补充这些字段的查询

---

🚀 立即执行的操作

Step 1: 重启后端服务 ⏳

IDEA重启：

1. 停止当前运行的 RuoYi-Admin 服务
2. 重新点击运行按钮

或命令行重启：

# 查找进程
ps aux | grep ruoyi-admin

# 停止进程（替换<PID>为实际进程ID）
kill -9 <PID>

# 重新启动
cd backend/ruoyi-admin
mvn spring-boot:run

Step 2: 刷新浏览器 ⏳

硬刷新（清除缓存）：

• Windows: Ctrl + Shift + R
• Mac: Cmd + Shift + R

---

🧪 测试步骤

1️⃣ 新增出国申请（上传两个附件）

1. 打开系统，点击"出国申请"菜单
2. 点击"新增申请"按钮
3. 填写表单：
   • 姓名：admin
   • 政治面貌：选择"中共党员"（重要！）
   • 部门：智能控制学院
   • 其他字段：按需填写
4. 上传出国境登记表盖章文件（PDF格式）
5. 上传党籍保留附件（PDF格式）
6. 点击"保存"或"提交"按钮

2️⃣ 查看详情（检查附件显示）

打开开发者工具

按 F12 打开浏览器开发者工具 → 点击 Console 标签

点击查看详情

在出国申请列表中，找到刚才新增的申请，点击"查看详情"按钮

检查控制台日志

期望看到以下日志：

📄 [查看详情] 开始查看申请详情，申请ID: 1234567890
✅ [查看详情] 申请详情获取成功: {...}

🔍 [党籍附件] 检查党籍保留附件字段:
  - partyRetentionUploadStatus: "1"              ← ✅ 应该为 "1"
  - partyRetentionFileName: "党籍保留材料.pdf"   ← ✅ 应该有文件名
  - partyRetentionFileOssId: 987654321           ← ✅ 关键：应该有OSS ID数字！
  - partyRetentionUploadTime: "2025-10-11 11:47:05"  ← ✅ 应该有上传时间

🔍 [盖章文件] 检查盖章文件字段:
  - stampedFileUploadStatus: "1"
  - stampedRegistrationFileName: "出国登记表-盖章.pdf"
  - stampedFileOssId: 123456789                  ← ✅ 关键：应该有OSS ID数字！
  - stampedFileUploadTime: "2025-10-11 11:47:03"

**⚠️ 本次修复重点**：
- 修复前：`stampedFileOssId` 和 `partyRetentionFileOssId` 为 `undefined` 或 `null`
- 修复后：应该显示具体的数字（如：`1933084077469929474`）

检查详情弹窗界面

期望显示：

• ✅ 出国境登记表盖章文件区域

  • 文件名：簡历_009_1755917613198 (4).pdf（或您上传的文件名）
  • 上传时间：2025-10-11 11:47:05
  • 下载按钮

• ✅ 党籍保留附件区域（红色边框）

  • 文件名：党籍保留材料.pdf（或您上传的文件名）
  • 上传时间：2025-10-11 11:47:08
  • 下载按钮

3️⃣ 测试下载功能

下载盖章文件

1. 点击"出国境登记表盖章文件"的"下载"按钮
2. 期望：
   • ✅ 浏览器开始下载文件
   • ✅ 文件名正确
   • ✅ 文件可以正常打开

下载党籍保留附件

1. 点击"党籍保留附件"的"下载"按钮
2. 期望：
   • ✅ 浏览器开始下载文件
   • ✅ 文件名正确
   • ✅ 文件可以正常打开

---

❌ 问题排查

问题1：党籍保留附件区域未显示

检查控制台日志

如果看到：

🔍 [党籍附件] 检查党籍保留附件字段:
  - partyRetentionUploadStatus: null      ← ❌ 问题：为 null 或 "0"
  - partyRetentionFileName: null
  - partyRetentionFileOssId: null

原因：上传时未正确保存到数据库

解决：

1. 检查上传逻辑
2. 确认上传成功后有设置 partyRetentionUploadStatus = '1'

---

如果看到：

🔍 [党籍附件] 检查党籍保留附件字段:
  - partyRetentionUploadStatus: undefined  ← ❌ 问题：后端未返回字段
  - partyRetentionFileName: undefined
  - partyRetentionFileOssId: undefined

原因：后端VO字段未生效

解决：

1. 确认后端已重启
2. 清空浏览器缓存并重新登录
3. 检查后端日志是否有错误

问题2：下载功能不可用

检查浏览器控制台错误

如果看到 401 错误：

Error: Request failed with status code 401

原因：认证失败，Token过期

解决：重新登录系统

---

如果看到 404 错误：

Error: Request failed with status code 404

原因：文件不存在或OSS ID无效

解决：

1. 检查控制台日志中的 stampedFileOssId 或 partyRetentionFileOssId 是否有值
2. 确认文件已成功上传到OSS

检查Network标签

1. 按 F12 打开开发者工具
2. 点击 Network 标签
3. 点击下载按钮
4. 查找 /resource/oss/download/{ossId} 请求
5. 查看状态码和响应

期望：

• 状态码：200 OK
• 响应类型：blob 或二进制数据

---

📋 测试检查清单

使用以下清单验证功能：

• 后端服务已重启
• 浏览器已硬刷新（Ctrl+Shift+R）
• 新增出国申请成功
• 上传出国境登记表盖章文件成功
• 上传党籍保留附件成功
• 点击"查看详情"按钮
• 开发者工具Console显示正确的日志
• 详情弹窗显示出国境登记表盖章文件
• 详情弹窗显示党籍保留附件（红色边框）
• 盖章文件下载成功
• 党籍保留附件下载成功
• 下载的文件可以正常打开

---

🎯 成功标准

必须满足的条件

1. ✅ 党籍保留附件区域显示

   • 在详情弹窗中能看到红色边框的党籍保留附件区域
   • 显示文件名和上传时间

2. ✅ 盖章文件区域显示

   • 在详情弹窗中能看到绿色背景的盖章文件区域
   • 显示文件名和上传时间

3. ✅ 下载功能正常

   • 点击下载按钮后文件开始下载
   • 下载的文件可以正常打开
   • 文件名正确

4. ✅ 控制台日志正确

   • partyRetentionUploadStatus 为 "1"
   • partyRetentionFileName 有值
   • partyRetentionFileOssId 有值
   • 无错误信息

---

📞 需要帮助？

如果测试过程中遇到问题，请提供以下信息：

1. 控制台日志截图（F12 → Console标签）
2. Network标签截图（F12 → Network标签，点击下载按钮后）
3. 详情弹窗截图（显示是否有党籍保留附件区域）
4. 具体错误信息（如果有的话）

---

修复完成时间：2025-10-11
参考文档：出国申请附件显示和下载问题修复方案.md