kyj-yanglao-web-new/debug-pdf-upload-unknown-error.md

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