调用Adobe PDF Service API出现INVALID_ZIP 400错误如何解决

引发原因 #

• 压缩包本身损坏：打包、传输过程中出现字节丢失，或压缩包后缀被人为篡改，本地无法正常解压
• 压缩包目录层级不符合规范：API要求HTML入口文件（默认是index.html）必须放在压缩包根目录，不能嵌套在任意子文件夹内。如果打包时选中了外层文件夹压缩，解压后需要先进入子文件夹才能看到入口文件，就会触发该错误
• 压缩格式不兼容：仅支持标准DEFLATE算法的ZIP格式，使用RAR、7z、tar.gz等其他格式，或者自定义了非标准压缩参数（如固实压缩、加密压缩、分卷压缩、超高压缩比）都会被判定为无效
• 压缩包内容违规：单压缩包大小超过100MB限制、包内存在带特殊字符（非ASCII字符、特殊符号）的文件名、包含损坏无法解析的静态资源
• 请求配置错误：上传请求的Content-Type未设置为application/zip，或压缩包二进制流被额外转码（如错误转为Base64字符串、多部分表单边界配置错误），导致服务端无法正确解析压缩包

排查解决方法 #

• 本地校验压缩包：用系统默认压缩工具尝试解压目标zip包，确认可正常打开，所有资源完整，且index.html直接在解压后的根目录，无外层嵌套文件夹
• 重新生成标准压缩包：选中所有需要打包的文件（包括index.html、css、图片等静态资源，不要选中外层文件夹），用系统默认的ZIP压缩选项生成压缩包，不要修改默认压缩参数，不要加密、不分卷
• 核对请求配置：确认上传请求的Content-Type为application/zip，压缩包以二进制流形式传递，没有被额外转码。如果使用官方SDK，确认传入的zip文件路径正确，没有传错其他格式文件
• 最小用例测试：仅打包一个包含简单静态内容的index.html（无其他额外资源）上传测试，如果可以正常请求，说明原压缩包内存在异常资源，逐一移除排查即可

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