Skip to content

DOCXKIT_PREVIEW_FETCH_FAILED: 预览文件获取失败 ​

未能成功从 URL 获取 DOCX 文件。

修复步骤 ​

  1. 检查 HTTP 响应、网络、身份验证与 CORS 设置。
  2. 无法远程获取时传入本地 DOCX 字节。

问题示例 ​

ts
import { createDocx, createDocxPreview } from 'docx-kit'

const container = document.createElement('div')
document.body.append(container)

const preview = createDocxPreview(container)
try {
  await preview.render('https://example.com/missing.docx')
} finally { preview.destroy() }

修复示例 ​

ts
import { createDocx, createDocxPreview } from 'docx-kit'

const container = document.createElement('div')
document.body.append(container)

const preview = createDocxPreview(container)
try {
  const blob = await createDocx().p('Hello').toBlob()
  await preview.render(blob)
} finally { preview.destroy() }

常见原因 ​

  • HTTP 响应失败、网络错误,或跨域请求被阻止。

诊断字段 ​

消息示例 ​

text
Failed to fetch DOCX: HTTP 404

源码与相关指南 ​

Released under the MIT License.