使用pdf-lib.js修改PDF遇报错：未找到PDF头且修改后无新增文本

问题分析 #

报错Uncaught (in promise) Error: Failed to parse PDF document (line:0 col:0 offset=0): No PDF header found说明代码读取到的内容不是有效的PDF文件，大概率是文件路径错误、请求失败或本地运行环境限制导致的；而下载的PDF和原文件一致，是因为解析失败后后续修改逻辑未执行，异常流程直接返回了原文件。

解决步骤 #

1. 核对PDF文件路径与文件名 #

• 确认Prueba.pdf和HTML文件在同一目录，检查文件名拼写（注意大小写，比如prueba.pdf和Prueba.pdf在Linux/macOS下是不同文件），避免文件名含空格或特殊字符。

2. 给fetch添加错误校验 #

在获取PDF文件时增加响应状态检查，快速定位请求问题，同时添加异常捕获：

document.getElementById('agregarTexto').addEventListener('click', async () => {
    try {
        const res = await fetch('Prueba.pdf');
        // 检查请求是否成功
        if (!res.ok) throw new Error(`请求PDF失败：${res.status} ${res.statusText}`);
        const existingPdfBytes = await res.arrayBuffer();
        
        const pdfDoc = await PDFLib.PDFDocument.load(existingPdfBytes);
        const pages = pdfDoc.getPages();
        const firstPage = pages[0];

        const arialFont = await pdfDoc.embedFont(PDFLib.StandardFonts.Helvetica);
        firstPage.drawText('Hola', {
            x: 105,
            y: 698,
            font: arialFont,
            size: 11,
            color: PDFLib.rgb(0, 0, 0),
        });

        const pdfBytes = await pdfDoc.save();
        const blob = new Blob([pdfBytes], { type: 'application/pdf' });
        const url = URL.createObjectURL(blob);
        
        const a = document.createElement('a');
        a.href = url;
        a.download = 'pruebapdf_modificado.pdf';
        a.style.display = 'none';
        document.body.appendChild(a);
        a.click();
        // 清理URL对象，避免内存泄漏
        URL.revokeObjectURL(url);
        document.body.removeChild(a);
    } catch (err) {
        console.error('处理PDF出错：', err);
        alert('修改PDF失败，请检查控制台错误信息');
    }
});

添加try/catch后能捕获错误并在控制台打印，方便排查具体问题。

3. 改用本地服务器运行页面 #

如果是直接双击打开HTML文件（file://协议），浏览器的安全限制会导致fetch无法正常读取本地文件。此时需要启动本地服务器：

• Python：在文件目录打开终端，执行python -m http.server（Python3）或python -m SimpleHTTPServer（Python2），然后访问http://localhost:8000
• Node.js：先安装http-server（npm install -g http-server），然后在文件目录执行http-server，访问终端输出的对应地址

4. 验证PDF文件有效性 #

用PDF阅读器打开Prueba.pdf，确认文件未损坏、能正常显示。如果文件本身损坏，pdf-lib无法解析，需要替换成正常的PDF文件。

内容的提问来源于stack exchange，提问作者TaquitoLoverDev