hzdyjs/🧪出国申请与审批PDF预览功能测试清单.md

🧪 出国申请与审批PDF预览功能测试清单

📋 修复范围

• ✅ 出国审批页面 - 完整修复（新增+修复+优化）
• ✅ 出国申请页面 - 优化修复（图片+下载）

---

🎯 快速测试步骤

准备工作（必须！）

# 1. 清除浏览器缓存
Ctrl + Shift + Delete → 清除缓存和Cookie

# 2. 强制刷新页面
Ctrl + Shift + R

# 3. 确认环境
前端: http://localhost
后端: http://localhost:8080

---

📝 测试清单

一、出国审批页面测试

测试路径

人事管理 → 出国管理 → 出国审批

测试项目

序号	测试项	操作步骤	预期结果	实际结果
1	附件显示	点击"查看详情"	✅ 显示盖章文件和党籍附件	⬜
2	盖章文件预览	点击"查看"按钮	✅ PDF在新窗口预览	⬜
3	盖章文件下载	点击"下载"按钮	✅ 正常下载PDF	⬜
4	党籍附件预览	点击"查看"按钮	✅ PDF在新窗口预览	⬜
5	党籍附件下载	点击"下载"按钮	✅ 正常下载PDF	⬜
6	图片附件预览	点击图片附件"查看"	✅ 图片在新窗口显示	⬜

重点验证

• ❌ 不应该: 点击"查看"后直接下载文件
• ✅ 应该: 点击"查看"后在新标签页预览
• ✅ 应该: PDF内容完整可滚动缩放
• ✅ 应该: 图片清晰可见

---

二、出国申请页面测试

测试路径

人事管理 → 出国管理 → 出国申请

测试项目

序号	测试项	操作步骤	预期结果	实际结果
1	附件显示	点击"查看详情"	✅ 显示盖章文件和党籍附件	⬜
2	盖章文件预览	点击"查看"按钮	✅ PDF在新窗口预览	⬜
3	盖章文件下载	点击"下载"按钮	✅ 正常下载PDF	⬜
4	党籍附件预览	点击"查看"按钮	✅ PDF在新窗口预览	⬜
5	党籍附件下载	点击"下载"按钮	✅ 正常下载PDF	⬜
6	图片附件预览	点击图片附件"查看"	✅ 图片在新窗口显示	⬜

重点验证

• ❌ 不应该: 点击"查看"后直接下载文件
• ✅ 应该: 点击"查看"后在新标签页预览
• ✅ 应该: PDF内容完整可滚动缩放
• ✅ 应该: 图片清晰可见

---

🔍 详细测试场景

场景1: PDF预览功能

1. 进入出国审批/申请页面
2. 找到任意一条有附件的记录
3. 点击"查看详情"
4. 定位到"盖章文件"或"党籍附件"
5. 点击"查看"按钮
6. 验证:
   • ✅ 新标签页自动打开
   • ✅ PDF文件正常渲染
   • ✅ 可以滚动和缩放
   • ❌ 不触发下载

场景2: 图片预览功能

1. 进入出国审批/申请页面
2. 找到图片格式的附件
3. 点击"查看"按钮
4. 验证:
   • ✅ 新窗口打开
   • ✅ 图片完整显示
   • ✅ 居中对齐
   • ❌ 不触发下载

场景3: 文件下载功能

1. 进入出国审批/申请页面
2. 点击任意附件的"下载"按钮
3. 验证:
   • ✅ 触发下载
   • ✅ 文件名正确
   • ✅ 文件类型正确
   • ✅ 文件完整可打开

场景4: 混合附件测试

1. 测试包含多个附件的记录
2. 分别测试PDF和图片附件
3. 验证:
   • ✅ 所有附件都能正常预览
   • ✅ 所有附件都能正常下载
   • ✅ 不同文件类型处理正确

---

🐛 常见问题排查

问题1: 点击"查看"还是下载

原因: 浏览器缓存未清除
解决:

Ctrl + Shift + Delete → 清除所有缓存
Ctrl + Shift + R → 强制刷新

问题2: 预览窗口空白

原因: 文件路径或权限问题
排查:

1. 检查浏览器控制台是否有404错误
2. 检查网络请求是否返回文件数据
3. 检查用户是否有查看权限

问题3: PDF显示不完整

原因: Blob大小异常
排查:

1. 打开浏览器开发者工具
2. 查看Console日志
3. 检查"Blob大小"日志

问题4: 图片无法显示

原因: MIME类型错误
排查:

1. 检查文件扩展名
2. 检查MIME类型设置
3. 确认图片文件完整性

---

📊 测试结果记录

出国审批页面

功能	状态	备注
附件显示	⬜
PDF预览	⬜
图片预览	⬜
文件下载	⬜

出国申请页面

功能	状态	备注
附件显示	⬜
PDF预览	⬜
图片预览	⬜
文件下载	⬜

---

✅ 通过标准

必须通过

• PDF点击"查看"在新窗口预览（不下载）
• 图片点击"查看"在新窗口显示（不下载）
• 文件点击"下载"正常下载
• 所有附件都能正确显示

建议测试

• 测试不同文件大小
• 测试不同文件格式
• 测试多个附件
• 测试不同浏览器（Chrome、Edge、Firefox）

---

📝 测试报告模板

测试环境

• 浏览器: ____________
• 版本: ____________
• 日期: 2025-10-13

测试结果

• 出国审批页面: ✅ 通过 / ❌ 失败
• 出国申请页面: ✅ 通过 / ❌ 失败

发现问题

1. ---

2. ---

3. ---

备注

---

---

🎯 后续优化建议

已完成 ✅

• 统一两个页面的附件处理逻辑
• 添加正确的MIME类型声明
• 优化Blob创建流程
• 增强文件类型识别

可选优化 ⏳

• 添加PDF预览进度提示
• 支持大文件分片加载
• 添加预览失败重试机制
• 支持更多文件格式预览（Word、Excel等）

---

测试时间: 2025-10-13
修复文档:

• 📋出国审批附件功能完整修复总结.md
• ✅出国申请页面PDF预览功能修复完成.md

请按照清单逐项测试，并反馈结果！ 😊