【テクニカル・上級編】Word VBAの実行時エラーをログとしてファイルに書き出す：保守性を高めるエラーハンドリングの設計思想 – Word VBA解析バイブル

Word VBA

2026.08.25

Word VBAを掌握する：破綻しないエラーハンドリングとログ基盤の設計思想

Word VBAのプロジェクトにおいて、最も恐ろしいのは「なぜ落ちたのか分からない」という状態だ。ユーザーの環境で発生した沈黙のクラッシュは、開発者にとっての悪夢であり、解決不可能な技術的負債となる。

本稿では、単なる `On Error Resume Next` の乱用を卒業し、プロフェッショナルな現場で求められる「自己防衛型」のエラーハンドリングと、システム保守の生命線となるログ基盤の実装について解説する。

—

VBAの実行時エラーは、発生源を特定するためのコンテキスト（文脈）が極めて希薄だ。Wordのオブジェクトモデル（`Application`, `Document`, `Range`）は、操作対象の状態に強く依存する。

保守性を高めるためには、「エラーを隠蔽するのではなく、エラーの発生状況をメタデータと共に書き出す」という設計思想が必要だ。単にエラー番号を出すだけでは不十分。どのプロシージャで、どのオブジェクトを操作している最中に、どんなパラメータで失敗したのか。これを構造化して記録する。

以下に、再利用性を極めたエラーハンドラの実装例を示す。ファイルシステムへのアクセスには、パフォーマンスと安定性を考慮し `Scripting.FileSystemObject` を採用する。

‘ —————————————————————————
‘ Module: Logger
‘ 概要: 実行時エラーを構造化してログファイルへ出力するユーティリティ
‘ —————————————————————————
Option Explicit

Public Sub WriteLog(ByVal procName As String, ByVal errNum As Long, ByVal errDesc As String)
Dim fso As Object
Dim ts As Object
Dim logPath As String

‘ ログファイルはユーザーのAppData配下を推奨。権限問題を回避する
logPath = Environ(“APPDATA”) & “\MyApp\ErrorLog.txt”

Set fso = CreateObject(“Scripting.FileSystemObject”)

‘ フォルダが存在しなければ作成
If Not fso.FolderExists(fso.GetParentFolderName(logPath)) Then
fso.CreateFolder fso.GetParentFolderName(logPath)
End If

‘ ファイル追記モード(8)で開く。Unicode対応が必要な場合はTristateTrueを指定
Set ts = fso.OpenTextFile(logPath, 8, True)

ts.WriteLine “[” & Now & “] PROC: ” & procName & ” | ERR: ” & errNum & ” | DESC: ” & errDesc

ts.Close

‘ オブジェクトの明示的解放（VBAのGCを過信しない）
Set ts = Nothing
Set fso = Nothing
End Sub

Word VBAでは、`Document`や`Range`、`Table`といったオブジェクトを不用意に生成・破棄し続けると、メモリリーク（特にWordのバックグラウンドプロセス）を引き起こす。

エラーハンドラを実装する際、`On Error GoTo` のラベル内でオブジェクトを解放し忘れると、エラーが発生するたびにメモリ消費量が増大していく。

Public Sub ProcessDocument()
Dim doc As Document
On Error GoTo ErrorHandler

Set doc = ActiveDocument
‘ ここで複雑なRange操作を行う

CleanExit:
‘ 常にクリーンアップを通す設計
Set doc = Nothing
Exit Sub

ErrorHandler:
Call WriteLog(“ProcessDocument”, Err.Number, Err.Description)
Resume CleanExit
End Sub

Wordがフリーズした際、VBAからログを出力する前にプロセス自体が強制終了してしまうケースがある。このような場合、VBA単体でのログ出力には限界がある。

さらなる高みを目指すなら、「外部常駐型の監視エージェント（VB.NETやC#で実装）」を検討すべきだ。VBAから名前付きパイプや、共有メモリ、あるいはWindowsイベントログを通じてエラーを外部へ通知する。

イベントログの活用: `WScript.Shell` を利用し、PowerShell経由でWindowsイベントログに書き込む手法は、企業の統合監視システムと連携できるため、大規模環境では極めて強力な武器となる。

優れた自動化コードとは、魔法のようなトリックを駆使するものではない。「何が起きても、最後にはログが真実を語る」という状態を作り上げることである。

あなたが書いたコードが、数年後に見知らぬ誰か（あるいは未来の自分）に引き継がれたとき、そのログファイルが「ここを確認すれば修正できる」という地図の役割を果たす。それこそが、伝説的なアーキテクトが目指すべき保守の姿だ。

Word VBAというレガシーなプラットフォームであっても、設計次第で堅牢なエンタープライズソリューションに昇華できる。まずは、上記のエラーハンドリングを貴殿のプロジェクトの標準装備にすることから始めてほしい。