iText7报错：AbstractITextEvent仅内部使用，求解决方案

这个错误的核心原因是iText7的内部事件机制不允许在UI线程中触发PDF文档初始化操作，也可能伴随依赖版本不兼容的情况。从栈追踪能看到，你的PDF创建逻辑是在MaterialDialog的点击回调（UI线程）中直接执行的，这违反了iText内部的线程安全设计，导致内部事件类AbstractITextEvent被错误调用。

1. 将PDF创建逻辑移到后台线程 #

UI线程仅负责处理用户交互，耗时的文件操作和PDF生成必须放在后台线程执行。推荐用Kotlin协程实现，示例代码如下：

// 在MaterialDialog的确认按钮点击回调中启动后台任务
materialDialog.setPositiveButton("生成PDF") { _, _ ->
    lifecycleScope.launch(Dispatchers.IO) {
        try {
            // 处理文件路径，用File构造器避免硬编码路径分隔符
            val docDir = Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_DOCUMENTS)
            val pdfFile = File(docDir, "$filename.pdf")
            
            if (!pdfFile.parentFile.exists()) {
                pdfFile.parentFile.mkdirs()
            }
            
            // 使用use块自动关闭资源，避免泄漏
            PdfWriter(pdfFile).use { writer ->
                PdfDocument(writer).use { pdf ->
                    // 在这里添加PDF内容示例
                    val page = pdf.addNewPage()
                    val canvas = PdfCanvas(page)
                    canvas.beginText()
                        .setFontAndSize(PdfFontFactory.createFont(StandardFonts.HELVETICA), 14f)
                        .moveText(50f, 750f)
                        .showText("测试PDF内容")
                        .endText()
                }
            }
            
            // 回到UI线程提示操作结果
            withContext(Dispatchers.Main) {
                Toast.makeText(context, "PDF创建成功", Toast.LENGTH_SHORT).show()
            }
        } catch (e: Exception) {
            e.printStackTrace()
            withContext(Dispatchers.Main) {
                Toast.makeText(context, "创建失败：${e.message}", Toast.LENGTH_SHORT).show()
            }
        }
    }
}

2. 确保iText7依赖版本一致 #

所有iText7相关依赖的版本必须完全匹配，避免版本冲突导致内部类初始化异常。比如在build.gradle中：

// 核心库
implementation 'com.itextpdf:itext7-core:7.2.7'
// 如果用到html转pdf等扩展模块，版本要和core一致
implementation 'com.itextpdf:html2pdf:7.2.7'

3. 适配Android 10+存储规则 #

Environment.getExternalStoragePublicDirectory在Android Q（API 29）后已被废弃：

• Android 11+如果要写入公共Documents目录，需要申请MANAGE_EXTERNAL_STORAGE权限；
• 更推荐使用应用专属存储或通过Intent让用户选择保存位置，避免权限问题。

• Android 6+需要动态申请WRITE_EXTERNAL_STORAGE权限（Android Q之前）；
• 始终用use块管理PdfWriter和PdfDocument资源，防止内存泄漏。

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