PuppeteerSharp v20.1.0 版本中的未观察任务异常问题分析

问题背景

在 WPF 应用程序开发中，许多开发者使用 PuppeteerSharp 库来处理 HTML 到 PDF 的转换功能。近期 PuppeteerSharp 升级到 v20.1.0 版本后，出现了一个值得关注的问题：当应用程序关闭时，会触发 TaskScheduler.UnobservedTaskException 事件，抛出"Target closed (Session closed)"异常。

问题现象

开发者在使用 PuppeteerSharp v20.1.0 时发现以下典型现象：

1. 应用程序功能本身工作正常，HTML 到 PDF 的转换能够正确执行
2. 当执行过至少一次转换操作后，关闭应用程序时会触发未观察任务异常
3. 异常信息显示："A Task's exception(s) were not observed either by Waiting on the Task or accessing its Exception property. As a result, the unobserved exception was rethrown by the finalizer thread. (Target closed (Session closed))"
4. 该问题在窗口关闭逻辑存在时尤为明显，即使是最简单的取消关闭操作也会触发异常

技术分析

这个问题本质上是一个任务异常未被正确处理的情况。在 .NET 中，当 Task 抛出异常但没有被观察（通过等待或访问 Exception 属性）时，垃圾回收器会在终结器线程中重新抛出这些异常。

在 PuppeteerSharp v20.1.0 中，内部实现引入了一个 _closeTaskCompletionSource 任务完成源，其异常仅由 WaitForNetworkIdleAsync() 方法读取。如果开发者没有调用这个方法（大多数简单场景下确实不会调用），就会导致异常未被观察，最终在应用程序关闭时触发未观察任务异常事件。

解决方案

PuppeteerSharp 开发团队迅速响应了这个问题，通过以下方式解决了该问题：

1. 回滚了引起问题的相关变更
2. 发布了修复版本 v20.1.1

开发者可以通过以下步骤解决问题：

1. 将 PuppeteerSharp 降级到 v20.0.5（临时解决方案）
2. 或者升级到修复版本 v20.1.1（推荐方案）

最佳实践建议

对于使用 PuppeteerSharp 的开发者，建议：

1. 始终处理 TaskScheduler.UnobservedTaskException 事件，即使只是记录日志
2. 定期检查并更新到最新稳定版本的 PuppeteerSharp
3. 在关闭应用程序时，确保所有 PuppeteerSharp 相关操作都已正确完成或取消
4. 对于长时间运行的操作，考虑实现适当的取消机制

总结

这个问题展示了异步编程中异常处理的重要性，特别是在涉及资源清理的场景下。PuppeteerSharp 团队快速响应并修复问题的做法值得肯定，同时也提醒我们在升级依赖库时需要关注可能的兼容性问题。对于开发者而言，理解任务异常处理机制有助于编写更健壮的异步代码。