「Documents.Open」の罠:大量図面処理におけるメモリリークを断つ、真のリソース解放戦略
大量のDWGファイルを順次処理するバッチシステムを構築する際、多くのエンジニアが直面する「壁」がある。
「最初は順調に動いていた処理が、数百枚を過ぎたあたりでAutoCADが応答なし(Not Responding)になる」「メモリ使用量が右肩上がりに増え続け、最終的にOut of Memoryでクラッシュする」――。
これは単なるプログラムのバグではない。オブジェクトのライフサイクルと、COM(Component Object Model)の参照カウントに対する理解不足が生む、必然的な破綻である。
本稿では、初心者向けの「Close」という概念を、シニアエンジニアが実践すべき「リソースの完全な破棄」へと昇華させるための、極限の知見を伝授する。
1. なぜ `Document.Close` だけでは足りないのか
初心者はこう考える。「`doc.Close` を呼び出せば、図面は閉じられ、メモリも解放されるはずだ」と。
残念ながら、それは致命的な誤解だ。
AutoCAD VBAにおいて、`Documents.Open` で取得した `Document` オブジェクトは、単なるファイルへのポインタではない。それはAutoCAD本体(`acad.exe`)のメモリ空間に居座る、極めて重厚なCOMオブジェクトである。
メモリが解放されないメカニズム
1. 参照カウントの残留: VBA側で `Dim doc As AcadDocument` と宣言し、オブジェクトを代入した瞬間、そのオブジェクトの参照カウントが上昇する。
2. Closeの限界: `doc.Close` メソッドは「図面を閉じる」というアクションを実行するが、「VBA変数としてのオブジェクト」をメモリから消去するわけではない。
3. COMのゴミ溜め: `Close` を呼んでも、VBAの変数 `doc` がそのオブジェクトを指し続けている限り、参照カウントはゼロにならず、AutoCADのメモリ空間には「実体のない、しかし参照は生きているオブジェクト」が蓄積され続ける。これがメモリリークの正体だ。
2. リソース解放の三位一体:完全なるクリーンアップ・サイクル
大量処理を完遂するためには、以下の3つのステップを一つのサイクルとして、ループ内で厳格に実行しなければならない。
① 明示的なオブジェクトの破棄 (`Set = Nothing`)
VBAにおいて、オブジェクトの参照を断ち切る唯一の方法は、変数に `Nothing` を代入することである。これにより、COMの参照カウントが減少し、条件を満たした時に初めてメモリが解放される。
② スケジューラーへの制御権譲渡 (`DoEvents`)
ループ処理が高速すぎると、Windowsのメッセージキュー(描画更新やOSからの信号処理)が追いつかず、AutoCADがフリーズしたように見える。`DoEvents` を挟むことで、OSに制御を一時的に戻し、メモリ管理プロセスやGUIの更新を促す。
③ 物理的なリソースの限界を見極める(アーキテクチャの選択)
もし数千枚規模の処理を行うのであれば、一つの `acad.exe` プロセス内で完結させること自体が設計ミスである。プロセスがクラッシュすれば、それまでの全工程が失われるからだ。
3. 実装コード:堅牢なバッチ処理パターン
以下に、メモリ消費を最小限に抑え、安定稼働を目的とした実装例を示す。これは、単なるコードではない。リソース管理の規律を具現化したものである。
' =================================================================
' 堅牢な図面バッチ処理モジュール
' 目的: 大量図面処理におけるメモリリークの徹底防止
' =================================================================
Option Explicit
Public Sub BatchProcessDrawings(ByVal fileList As Collection)
Dim acadApp As AcadApplication
Dim doc As AcadDocument
Dim filePath As Variant
On Error GoTo ErrorHandler
' AutoCADアプリケーションへの参照取得
Set acadApp = ThisDrawing.Application
' ファイルリストのループ処理
For Each filePath In fileList
Debug.Print "Processing: " & filePath
' --- 1. 図面のオープン ---
Set doc = acadApp.Documents.Open(filePath)
' --- 2. 図面処理ロジック (ここに実処理を記述) ---
Call ExecuteHeavyLogic(doc)
' --- 3. 保存とクローズ ---
' 変更がある場合のみ保存。エラー回避のためOn Error Resume Nextを併用
On Error Resume Next
doc.Save
doc.Close
On Error GoTo ErrorHandler
' --- 4. 【極めて重要】リソースの明示的解放 ---
' オブジェクトへの参照を完全に断ち切る
Set doc = Nothing
' OSのメッセージキューを処理させ、メモリ管理プロセスに隙を与える
DoEvents
' ループの各ステップで、メモリ使用量を確認することを推奨する
Next filePath
MsgBox "全ての処理が正常に完了しました。", vbInformation
Exit Sub
ErrorHandler:
MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
"Error No: " & Err.Number & vbCrLf & _
"Description: " & Err.Description, vbCritical
' エラー時も、可能な限りオブジェクトを解放してプロセスを保護する
If Not doc Is Nothing Then
Set doc = Nothing
End If
End Sub
Private Sub ExecuteHeavyLogic(ByRef doc As AcadDocument)
' ここに図面操作のロジックを記述
' 例: 全レイヤーのチェック、属性抽出など
' 注意: この内部でも、生成したオブジェクト(AcadEntity等)は
' 必ず Set = Nothing で解放すること
End Sub
4. 伝説のアーキテクトが教える「究極の回避策」
もし、上記の対策を講じてもメモリ不足が解消されない場合、それはAutoCAD本体(`acad.exe`)が持つ、累積的なメモリ断片化(Fragmentation)の問題である。
シニアエンジニアとして、君が検討すべき次の一手は「プロセス分離型アーキテクチャ」への移行だ。
プロセス分離(Process Isolation)の戦略
VBA内部のループで処理するのではなく、外部のスクリプト(VBScriptやPowerShell、あるいはVB.NETで作成したコンソールアプリケーション)からAutoCADを制御する。
1. Controller(外部プログラム)が図面リストを読み込む。
2. Worker(AutoCAD)を起動する。
3. 図面を N枚(例: 50枚) 処理する。
4. Worker(AutoCADのプロセス自体)を強制終了させる。
5. 再度、新しい Worker(AutoCAD) を立ち上げる。
この「プロセスを定期的に殺して、新しく作り直す」という手法は、一見非効率に見える。しかし、数千枚の図面を「止まらずに、最後まで」処理するという観点においては、これこそが最も信頼性の高い、プロフェッショナルの選択である。
結論
`Documents.Open` は、魔法の杖ではない。それは、システムのメモリという限られた資源を消費する、重い契約である。
- `Close` は契約の終了ではなく、手続きの開始に過ぎない。
- `Set = Nothing` は、メモリに対する責任の証明である。
- `DoEvents` は、システムとの対話である。
これらを遵守し、必要であればプロセスレベルでの制御を設計に組み込め。それが、レガシーな環境においても堅牢なシステムを構築できる、真のエンジニアの姿である。
