修复 IronPDF 中的内存泄露

Curtis Chau

已更新:六月 1, 2025

Translated

View the article in English

如果您在使用IronPDF时遇到明显的内存泄漏，我们希望了解这一情况。我们最资深的工程师将集中力量解决一旦确定的内存泄漏问题。

以下是向support@ironsoftware.com报告内存泄漏的方法：

1. 更新到最新的IronPdf版本

如果您还没有，请更新到最新的IronPdf版本。

2. 确保您的`IDisposable`对象已被释放

报告的大多数内存泄漏是由于不正确地使用.NET IDisposable接口引起的。

如果任何.NET类具有Dispose()方法—它可能是IDisposable，并且需要开发人员在使用完后通知它。

有一个常见的误解，认为C#是一种"托管"语言，不需要开发人员负责管理内存。与这种观点相反，实际上有许多常见的.NET对象开发人员未能释放。

未能手动释放每个IDisposable类实例可能会导致代码中的内存泄漏。

System.IO.Stream - 它由PdfDocument.Stream属性返回。
System.Drawing.Image / System.Drawing.Bitmap - 由PdfDocument.PageToBitmap方法返回。
IronPdf.PdfDocument - 本身也标记为IDisposable，因为在我们2021至2024年以后的版本中可能包含非托管对象。

最常见的解决方案

最佳解决方案通常是在引用`IDisposable`对象时使用`using`语句。

using(var stream = myPdfDocument.Stream) {
    // Perform operations with the stream here
}

using(var stream = myPdfDocument.Stream) {
    // Perform operations with the stream here
}

$vbLabelText $csharpLabel

在C# 8中，甚至有一个不需要{}闭包的简写版本。

using var stream = myPdfDocument.Stream;
// Perform operations with the stream here

using var stream = myPdfDocument.Stream;
// Perform operations with the stream here

$vbLabelText $csharpLabel

3. 垃圾回收

即使没有问题，Visual Studio调试器内存分析器可能仍然显示增长。在使用高RAM系统时，.NET运行时可能会认为让垃圾留在内存中直到系统RAM几乎满时甚至使用交换文件是更高效的。

可以手动指示.NET垃圾收集器在应用程序生命周期的安全点处释放其未使用对象，例如：

未渲染PDF时
开放的IDisposable对象

实现这种操作的一种方法是：

System.GC.Collect(); // Invokes the garbage collector
System.GC.WaitForPendingFinalizers(); // Waits for the process to complete
System.GC.Collect(); // Optional: Runs additional collection to ensure all objects are cleared

System.GC.Collect(); // Invokes the garbage collector
System.GC.WaitForPendingFinalizers(); // Waits for the process to complete
System.GC.Collect(); // Optional: Runs additional collection to ensure all objects are cleared

$vbLabelText $csharpLabel

在此之后，内存使用图表应下降到正常但非零水平。