【Claude Code】PDF too large (max 100 pages, 32 MB). Try splitting it or extPDF 错误合集:过大、加密、无效文件的三种处理方案

【Claude Code】PDF too large (max 100 pages, 32 MB). Try splitting it or extPDF 错误合集:过大、加密、无效文件的三种处理方案

文章目录

    • 一、问题描述
      • 1.1 环境信息
      • 1.2 报错现象
    • 二、根因分析
      • 2.1 错误链路追踪
      • 2.2 可能原因列举
    • 三、解决方案
      • A. 针对 PDF 过大(变体 A)
        • 方案 A-1:使用 Read 工具分段读取(推荐)
        • 方案 A-2:pdftotext 提取纯文本
        • 方案 A-3:拆分 PDF 文件
        • 方案 A-4:压缩 PDF 文件
      • B. 针对 PDF 加密(变体 B)
        • 方案 B-1:pdftotext 提取(即使加密也可尝试)
        • 方案 B-2:使用 qpdf 移除密码(推荐)
        • 方案 B-3:重新导出/打印为 PDF
      • C. 针对 PDF 无效(变体 C)
        • 方案 C-1:重新导出 PDF(推荐)
        • 方案 C-2:先转图片再转 PDF
        • 方案 C-3:提取纯文本
    • 四、验证与回归测试
    • 五、总结与预防
      • 5.1 核心要点
      • 5.2 最佳实践建议
    • 六、参考资料

一、问题描述

1.1 环境信息

项目详情
工具Claude Code (CLI)
PDF 页数限制最大 100 页
PDF 文件大小限制最大 32 MB
触发场景附加超出限制、加密或损坏的 PDF

1.2 报错现象

当你向 Claude Code 附加一个 PDF 文件时,可能遇到以下三种错误之一:

变体 A:PDF 过大

PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.

变体 B:PDF 有密码保护

PDF is password protected. Try removing pro