# Debug Session: PDF Upload UnknownErrorException

## Session ID
pdf-upload-unknown-error

## Status
[OPEN]

## Symptom
上传 PDF 文件时，前端提示"PDF 解析失败 UnknownErrorException"，错误位置在 DocumentAttachmentBody.vue:85（catch 块）。

## Environment
- Browser DevTools Network 显示 `pdf.worker.mjs` 请求返回 304 Not Modified
- 请求 URL: `http://localhost/pdf.worker.mjs`

## Hypotheses
1. `pdfjs-dist` worker 路径 `/pdf.worker.mjs` 与实际部署路径不匹配，导致 worker 加载后执行失败
2. 当前 PDF 文件本身损坏或格式特殊，触发 pdfjs 解析异常
3. pdfjs-dist 版本与 public 目录下的 `pdf.worker.mjs` 文件版本不一致
4. Worker 跨域或 MIME 类型问题导致 pdfjs 无法正确实例化 worker
5. 动态 import('pdfjs-dist') 时 GlobalWorkerOptions 未正确设置，导致 worker 未生效

## Evidence
- `node_modules/pdfjs-dist/package.json` 版本为 `4.10.38`
- `public/pdf.worker.mjs` 原文件中 `workerVersion` 与 `pdfjsVersion` 为旧版本，与安装的 `pdfjs-dist` 不匹配
- 版本不一致会导致 worker 与主库通信协议不兼容，从而抛出 `UnknownErrorException`

## Fix Applied
将 `node_modules/pdfjs-dist/build/pdf.worker.mjs` 复制到 `public/pdf.worker.mjs`，确保 worker 版本与主库完全一致（均为 `4.10.38`）。

## Verification
请重新上传 PDF 文件验证。如仍报错，请提供新的控制台错误信息。

## Created At
2026-07-20