changelog: 保单PDF预览问题说明

changelogs/2026-03/26_1500_pdf_preview.md

@@ -0,0 +1,30 @@
+# 保单PDF预览变成下载的问题
+
+**日期**: 2026-03-26
+**类型**: 前端BUG
+
+---
+
+## 问题
+
+保单PDF预览弹窗显示"该文件类型暂不支持在线预览"，点击后变成下载。
+
+## 原因
+
+前端通过 `/admin/file/preview-by-url` 代理预览，dev server 代理可能丢失了 `Content-Type: application/pdf` 和 `Content-Disposition: inline` 响应头。
+
+## 解决方案
+
+**推荐**：保单PDF已有公网可直接访问的OSS链接（`policyPdfUrl` 字段），前端直接用这个URL预览，不需要经过后端代理：
+
+```js
+// 方案1：新窗口打开（最简单）
+window.open(record.policyPdfUrl)
+
+// 方案2：iframe嵌入弹窗
+<iframe :src="record.policyPdfUrl" style="width:100%;height:80vh" />
+```
+
+`policyPdfUrl` 在保险订单详情 `GET /admin/insurance/order/{id}` 和订单详情的 `insurances` 列表中都有返回。
+
+如果坚持用 `/admin/file/preview-by-url`，检查前端 dev server 代理配置是否正确转发了 response headers。