在现代 Web 服务和边缘函数（如 Supabase Edge Functions）中，处理来自外部 URL 的 PDF 文件并提取其文本内容是一项常见的需求。然而，在 Deno 这样的运行时环境中，寻找一个稳定且功能完备的 PDF 处理库可能会遇到挑战。
常见误区：pdf-lib 的局限性
许多开发者在 Deno 中尝试处理 PDF 时，可能会自然而然地考虑使用 pdf-lib。pdf-lib 是一个功能强大的库，主要用于创建、修改和签名 PDF 文档。它提供了加载 PDF、获取页面、甚至处理表单字段（AcroForm）的能力。然而，一个常见的误区是期望 pdf-lib 能够直接支持任意 PDF 内容的通用文本提取。
例如，以下尝试使用 pdf-lib 提取文本的代码段：
import { PDFDocument } from 'https://cdn.skypack.dev/pdf-lib';
async function fetchPDF(url: string): Promise {
const response = await fetch(url);
const data = await response.arrayBuffer();
return new Uint8Array(data);
}
async function readPDFText(url: string): Promise {
const pdfBytes = await fetchPDF(url);
const pdfDoc = await PDFDocument.load(pdfBytes);
const pages = pdfDoc.getPages();
let text = '';
for (const page of pages) {
// 这里的 .extractText() 或 .getTextContent() 方法并不存在或不支持通用文本提取
// 尝试调用会引发 TypeError: .extractText is not a function
// const content = await page.extractText();
// text += content;
}
return text;
}
// 实际使用时，上述尝试会遇到 TypeError
// const pdfUrl = 'YOUR_PDF_URL_HERE';
// const pdfText = await readPDFText(pdfUrl);
// console.log(pdfText); 如上述代码所示，尝试调用 page.extractText() 或 page.getTextContent() 方法时，通常会遇到 TypeError: .extractText() is not a function 错误。这是因为 pdf-lib 的设计目标并非通用文本解析，其官方文档和社区讨论也明确指出，它目前不支持从文档中解析纯文本内容（除了 AcroForm 字段）。对于通用文本提取，官方建议考虑使用如 PDF.js 等专门的解析库。
解决方案：利用 pdf-parse 进行文本提取
Deno 运行时的一大优势是其对 npm 模块的良好兼容性，允许我们直接通过 npm: 协议导入并使用绝大多数 npm 包。对于 PDF 文本提取任务，pdf-parse 是一个轻量级且高效的解决方案，它底层依赖于 PDF.js，能够可靠地从 PDF 文件中解析出文本内容。
以下是如何在 Deno 中使用 pdf-parse 从 URL 获取 PDF 并提取文本的完整示例：
import pdf from 'npm:pdf-parse/lib/pdf-parse.js'; /** * 从指定 URL 获取 PDF 文件并提取其文本内容。 * @param pdfUrl PDF 文件的 URL。 * @returns 提取到的文本内容。 */ async function extractTextFromPDF(pdfUrl: string): Promise{ try { // 1. 从 URL 获取 PDF 文件的二进制数据 const response = await fetch(pdfUrl); if (!response.ok) { throw new Error(`Failed to fetch PDF from ${pdfUrl}: ${response.statusText}`); } const arrayBuffer = await response.arrayBuffer(); // 2. 使用 pdf-parse 处理二进制数据并提取文本 // pdf-parse 函数接受 ArrayBuffer 或 Buffer，并返回包含文本等信息的对象 const data = await pdf(arrayBuffer); // 3. 返回提取到的文本内容 return data.text; } catch (error) { console.error("Error extracting text from PDF:", error); throw error; // 重新抛出错误以便调用方处理 } } // 示例用法： const pdfUrl = 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf'; // 替换为你的 PDF URL try { console.log(`正在从 ${pdfUrl} 提取文本...`); const pdfText = await extractTextFromPDF(pdfUrl); console.log("提取到的 PDF 文本内容:"); console.log(pdfText); } catch (e) { console.error("无法提取 PDF 文本:", e); }
代码解析：
- import pdf from 'npm:pdf-parse/lib/pdf-parse.js';: 这是 Deno 中导入 npm 包的标准方式。pdf-parse 的主入口文件位于其 lib 目录下。
- fetch(pdfUrl): 使用 Deno 内置的 fetch API 从指定的 URL 获取 PDF 文件的响应。
- response.arrayBuffer(): 将响应体转换为 ArrayBuffer，这是 pdf-parse 所需的二进制数据格式。
- await pdf(arrayBuffer): 调用 pdf-parse 库的默认导出函数，传入 ArrayBuffer。该函数会异步解析 PDF 内容，并返回一个包含 text 属性（即提取到的文本）的对象。
- return data.text: 从解析结果中获取并返回纯文本内容。
注意事项与最佳实践
- Deno 版本兼容性： 确保您的 Deno 版本支持 npm: 协议（通常较新版本都支持）。
- 错误处理： 在实际应用中，务必对网络请求（fetch）和 PDF 解析过程（pdf-parse）进行充分的错误处理，例如检查 response.ok，捕获潜在的解析异常。
- 性能考量： 对于非常大的 PDF 文件，文本提取可能需要一定的时间和内存。在边缘函数等资源受限的环境中，应评估其性能影响。
- 文本格式与布局： pdf-parse 提取的文本通常是原始的、不带格式的文本流。PDF 的复杂布局（如多列、图表中的文本）可能会导致提取的文本顺序或可读性不佳。如果需要更高级的文本结构保留，可能需要更复杂的解析逻辑或专门的工具。
- 替代方案： 如果 pdf-parse 无法满足特定需求（例如，需要解析 PDF 内部的图像文本、更精确的文本定位信息），可以考虑直接集成或调用基于 PDF.js 的更底层解析逻辑，或者探索其他专门的 OCR 解决方案。
总结
在 Deno 环境中从 URL 获取 PDF 并提取文本，关键在于选择正确的库。尽管 pdf-lib 在 PDF 操作方面表现出色，但它并非为通用文本提取而设计。通过利用 Deno 对 npm 模块的兼容性，pdf-parse 提供了一个简单而有效的解决方案，能够帮助开发者轻松实现 PDF 文本内容的自动化提取。遵循本文提供的示例和注意事项，您将能够高效地在 Deno 应用中处理 PDF 数据。
