CATIA

CATIAマクロのエラーが再現しない時、何を疑うか

2026.04.23 / 読了目安 8分 / 執筆: Qronix 開発チーム

#CATIA#CATIAマクロ#開発の作法

「エラーが出ました」という報告を受けて、手元で同じ操作をしても再現しない。CATIAマクロのデバッグで最も時間を溶かす場面です。私たちは再現しないエラーを、環境・状態・タイミングの3つに分類して潰します。その具体的な手順と、現場で本当に効いた対処を書きます。

作業中のPC画面Photo: Unsplash
CONTENTS
1. 再現しないエラーは3種類しかない 2. 環境差分——まず疑うのは設定ファイルとリリース 3. 状態依存——コードではなくデータを疑う 4. タイミング——CATIAが返事をする前に次へ行っていないか 5. 再現しないなら、再現させる仕掛けを埋め込む

再現しないエラーは3種類しかない

まず切り分けの地図を持ってください。CATIAマクロで再現しないエラーは、突き詰めると3種類です。環境差分(相手のPCと自分のPCが違う)、状態依存(相手のデータやCATIAの状態が違う)、タイミング(処理の速さや順序が違う)。この3つのどれかです。

闇雲にコードを読み返す前に、どれに当たるかを絞る。これだけで調査時間が半分以下になります。逆に、この分類を持たずに「なんとなく怪しいところ」を直していくと、直ったように見えて数週間後に同じ現象が再発します。エラー対処で一番怖いのは、原因が分からないまま消えてしまうことです。

分類のための最初の質問は3つだけです。ひとつ、他の人のPCでは起きるか。ふたつ、他のデータでも起きるか。みっつ、毎回起きるか。この答えの組み合わせで、ほぼ当たりがつきます。全員のPCで、全データで、毎回起きるなら、それはそもそも再現するバグです。話は簡単です。

厄介なのは「特定の人の、特定のデータで、たまに起きる」です。これは3要素が絡んでいます。私たちの経験では、この複合パターンが再現しないエラーの体感で4割を占めます。焦らず、一要素ずつ固定して潰していきます。

再現しないエラーの切り分け環境差分相手のPCと自分のPCが違う/リリース・SP・設定状態依存相手のデータやCATIAの状態が違うタイミング処理の速さや順序が違う
「他の人のPCでは起きるか」「他のデータでも起きるか」「毎回起きるか」——この3つの答えで、ほぼ当たりがつく。

環境差分——まず疑うのは設定ファイルとリリース

環境差分で最初に確認するのは、CATIAのリリースとサービスパックです。R系のバージョンが同じでも、SPが違えばAPIの挙動が変わることは普通にあります。特に、あるSPで仕様が厳格化されて、それまで通っていた曖昧な書き方がエラーになるパターン。私たちは実際に、パラメータの型変換の扱いが変わって既存ツールが一斉に止まった事例を経験しています。

次にCATIA設定(Settings)です。ツール・オプションの内容はユーザーごとのCATSettingsに保存されます。たとえば、更新を手動にしているか自動にしているか。これだけでマクロの結果は変わります。自分の環境では自動更新が効いて形状が最新になっていたのに、相手の環境では手動設定で古い形状のまま処理されていた——非常によくあります。

環境変数とパスも見ます。参照先のライブラリやテンプレート、標準部品の格納先がユーザーごとに違っていないか。ネットワークのマウント状態が違わないか。CATIAが読む設定は複数のファイルに分散していて、しかも管理者配布と個人設定が混ざります。私たちは、環境情報を吐き出す小さな診断マクロを必ずセットで納品しています。

この診断マクロは、リリース、SP、主要な設定値、参照パス、ユーザー名、PC名をテキストに書き出すだけのものです。20行程度で書けます。「エラーが出ました」の報告に、この出力を1枚添えてもらうルールにする。それだけで、環境差分由来の調査は数時間から数分になります。投資対効果が最も高いデバッグ用の道具です。

デバッグの実力差はコードを読む速さではない。
証拠を残す設計にしていたかで決まる。

状態依存——コードではなくデータを疑う

状態依存は、コードが正しくてもデータが想定外だと落ちる類のものです。CATIAのデータは現場で何年も引き継がれるうちに、設計者本人も知らない状態を抱え込んでいます。ここを甘く見ると、いつまでもデバッグが終わりません。

頻出するのは、同名要素です。同じ名前のボディやスケッチが複数ある。名前でオブジェクトを取得するコードは、この瞬間に破綻します。しかも取得できてしまうので、エラーにならずに「間違った要素を処理する」という最悪の形で表面化します。私たちは名前検索の結果が1件であることを必ず検証し、複数なら止めるようにしています。

次に、更新エラーを抱えたまま保存されたデータです。赤いマークが出ているのに、設計者が「後で直す」つもりで保存してそのまま数か月。この状態でマクロが形状を参照すると、返ってくる値が不定になります。処理の冒頭でドキュメントの更新状態を確認し、異常があれば処理せず報告する。これも自働化の考え方です。

見落としやすいのが、非表示要素、非アクティブなボディ、そして日本語や記号を含む要素名です。全角スペースが混じった名前、末尾に半角スペースが付いた名前。目視では絶対に気づきません。私たちは調査時、対象データの要素名を全部ダンプして、文字コードレベルで比較します。ここで原因が見つかることが本当に多い。

VBA弊社共通ライブラリより抜粋(clsCatHelperLib):デバッグモードとダンプ出力
'*********************************************************************************
'*  ダンプ
'*  param: sTxt-文字
'*********************************************************************************
Public Sub Dump( _
        ByVal sTxt As String)
    
    If Not m_DebugMode Then Exit Sub
    Debug.Print sTxt
End Sub

デバッグモードのフラグはクラス初期化で持たせ、配布後も切り替えられるようにしています。

タイミング——CATIAが返事をする前に次へ行っていないか

3つ目のタイミング問題は、最も再現しにくく、最も厄介です。マクロが命令を出した直後、CATIAはまだ内部処理を終えていません。しかしマクロは次の行へ進んでしまう。速いPCでは処理が追いつかず、遅いPCでは間に合う。逆のこともあります。だから「あの人のPCだけ落ちる」が起きます。

典型は、ドキュメントを開いた直後、更新を実行した直後、他アプリとの連携を挟んだ直後です。ここで即座に形状を参照すると、まだ準備できていないオブジェクトを掴んでしまう。私たちは、待つのではなく確かめる方式を取ります。決め打ちの待機時間を入れるのではなく、目的の状態になったかを短い間隔で確認し、なったら進む。上限時間を超えたら異常として止める。

固定のスリープを入れる対処は、その場では効きますが後で必ず壊れます。PCが速くなれば無駄な待ち時間になり、データが重くなれば足りなくなる。しかも何秒が適切かの根拠がどこにも残りません。数年後に触る人が減らすことも増やすこともできない、触れない数字が残るだけです。

並行して疑うべきは、CATIAの外側との連携です。Excelを操作している、ファイルサーバに書き込んでいる、PDMにアクセスしている。この境界でタイミング問題は集中的に発生します。特にExcelは、オブジェクトの解放が甘いと見えないプロセスが残り、次の実行で不可解な失敗を起こします。連携部分は、他のどこよりも丁寧に書く価値があります。

固定スリープと状態確認固定のスリープを入れる3秒を決め打ちPCが速くなれば無駄、データが重くなれば足りない目的の状態になったか確認0.2秒間隔で確認上限時間を超えたら異常として止める
待つのではなく確かめる。決め打ちの秒数は根拠が残らず、数年後に触れない数字になる。

再現しないなら、再現させる仕掛けを埋め込む

ここまでの切り分けをやっても原因が見えないとき、私たちが最後に取る手段は、現場のPCで証拠を採ることです。手元で再現させようとするのをやめて、実際に起きている場所で情報を残す。これが結局いちばん速い。

具体的には、通常運転でも軽く動く記録機能をツールに常時仕込んでおきます。処理の主要な区切りごとに、時刻、処理対象、要素数、直前の操作結果を1行ずつ追記する。ファイルサイズが問題になるなら日付ごとに分ける。この記録があると、落ちた瞬間の直前3行を見るだけで原因の見当がつきます。

加えて、エラーハンドラの中でその場の状況をまとめて保存させます。エラー番号と説明だけでは足りません。処理していたファイル名、対象要素の名前と型、ループの何回目か。ここまで書いておけば、報告メールに添付ファイルが1つ付くだけで調査が完結します。設計者に「どんな操作をしましたか」と聞き返す必要がなくなります。

私たちがCATIA一筋22年、累計500本超のツールを現場に入れてきて確信していることがあります。デバッグの実力差は、コードを読む速さではなく、証拠をどれだけ残す設計にしていたかで決まります。再現しないエラーへの最良の対処は、起きる前の設計に含まれている。エラー対処を後工程だと思わないでください。

そして、原因が特定できないまま「なんとなく直った」で終わらせないこと。再現しないエラーは、必ずもう一度戻ってきます。分からないなら分からないと記録に残し、次に起きたときの観測点を増やしておく。これが長く使われるツールの作法です。

同じような自働化を検討中でしたら、一度話を聞かせてください。ヒアリングと自働化設計書の提案までは無料で行っています。使えるものが無ければ、無いとお伝えします。

証拠を残す仕掛けを先に埋める1環境情報の診断出力を添付させるリリース・SP・設定値・参照パス・PC名2通常運転でも軽く動く記録を常時仕込む時刻・処理対象・要素数・直前の操作結果を1行ずつ3エラーハンドラで状況ごと保存するファイル名・要素名と型・ループの何回目か4分からないなら分からないと記録に残す次に起きたときの観測点を増やしておく
手元で再現させようとするのをやめ、実際に起きている場所で情報を残す。デバッグの実力差はここで決まる。
再現しないエラーを一要素ずつ潰すエラーが出たと報告が来る全員のPC・全データで毎回起きる?再現するバグとして直す特定のPCだけで起きる?環境差分:診断マクロでSPや設定を比較特定のデータだけで起きる?状態依存:要素名をダンプして比較たまにしか起きない?タイミング:状態を確かめてから進む原因が見えた?現場のPCに記録を仕込んで証拠を採る原因を特定して直し記録に残す対処完了はいいいえはいいいえはいいいえはいいいえ見えない見えた
図4: 3つの質問で環境差分・状態依存・タイミングを順に疑い、見えなければ現場で証拠を採る流れ。
Qronix 開発チーム

CATIA歴22年超・愛知県の大手自動車メーカー及びグループ各社でCATIAツール開発の技術責任者を務めたメンバーを中心とする、CAD自働化のスペシャリスト集団。2024年創業、特許第7907964号を保有。

「うちの資産でもできる?」
まずその質問からどうぞ。

できる・できないの判定と自働化設計書のご提案までは無料です。

contact@qronix.jp へ相談する
記事一覧をすべて見る →
← 記事一覧へトップページへ →