Android签名APK无法打开PDF，未签名APK正常问题排查

先排除ProGuard的可能 #

你已经设置minifyEnabled false，ProGuard代码混淆/压缩不会生效，所以这个报错和ProGuard无关。

核心原因分析 #

报错java.io.IOException: The document has no pages来自itextpdf的PdfPages.writePageTree方法，说明签名打包后，要么PDF文件本身损坏，要么读取逻辑无法正确加载到有效PDF内容。

具体排查方向 #

• PDF文件被错误压缩：签名打包时，aapt可能会对assets目录下的PDF文件进行压缩，导致文件损坏。在app级build.gradle的android块里添加配置，禁止压缩PDF：

  aaptOptions {
      noCompress 'pdf'
  }
  

• 文件读取路径/方式错误：debug和release模式下，文件访问逻辑可能存在差异。确保读取PDF时用标准的Assets读取方式，比如：

  InputStream is = getAssets().open("your_file.pdf");
  

  避免使用硬编码的本地路径，release打包后这类路径可能失效。
• itextpdf版本兼容性：部分旧版itextpdf在release字节码优化后可能出现异常，尝试升级到最新稳定版，或者检查依赖是否完整。
• 签名配置干扰：尝试更换签名文件，或者调整签名时的v1/v2/v3选项（比如暂时只开启v1签名），部分设备对新签名格式的兼容性可能影响文件读取。

快速调试技巧 #

• 解压签名后的APK，对比assets里的PDF文件和debug包中的文件大小、MD5值，确认文件是否完整。
• 在release构建中开启调试：在build.gradle的release块添加debuggable true，然后用Android Studio附加到进程，追踪具体是哪个PDF读取失败，定位代码执行的异常点。

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