【解決】 Salesforce: Apex CPU time limit exceeded の解決方法と原因 | Salesforce トラブルシューティング

Salesforceをご利用中の皆さん、突然「Apex CPU time limit exceeded」というエラーメッセージに遭遇し、業務がストップしてしまった経験はありませんか？このエラーは、Apexコードの処理がSalesforceが定めるCPU使用時間の制限を超過した際に発生します。結論から申し上げますと、この問題は**Apexコードの効率性を改善する**ことで解決できます。

この記事では、Windowsユーザーの皆さんがこの厄介なエラーを迅速に特定し、恒久的に解決するための具体的な手順を、コマンドライン（PowerShell/Cmd）を交えながらご紹介します。ご安心ください、解決策は必ず見つかります。

1. Salesforce: Apex CPU time limit exceeded とは？（概要と緊急度）

「Apex CPU time limit exceeded」エラーは、Salesforceプラットフォーム上で実行されるApexコードが、定められたCPU実行時間（同期処理の場合10秒）を超過したことを示すガバナ制限エラーです。これは、コードが過度に複雑な処理を行っているか、大量のデータを非効率に扱っている場合に発生します。

このエラーが発生すると、ユーザーは特定の操作を実行できなくなり、ビジネスプロセスが中断されるため、**緊急度は非常に高い**と言えます。特に、ユーザーが頻繁に利用する機能や、自動化された重要な処理で発生した場合は、迅速な対応が求められます。

2. 【最速】今すぐ試すべき解決策

「Apex CPU time limit exceeded」エラーの根本的な解決にはコードの改修が必要ですが、まずは原因を特定するための情報収集が最優先です。ここでは、Windows環境でSalesforce CLI（SF CLI）を活用し、デバッグログを取得する方法と、一時的な対処のヒントをご紹介します。

解決策1：デバッグログによる原因特定と一時的な対処のヒント

Salesforce CLIは、コマンドラインからSalesforce組織を操作するための強力なツールです。これを使ってデバッグログを取得し、問題の原因となっているApexクラスやトリガー、処理のボトルネックを特定しましょう。

ステップ1: Salesforce CLIのインストールと認証

まだSalesforce CLIをインストールしていない場合は、以下の手順でインストールし、Salesforce組織への認証を行います。

  1. Salesforce CLIの公式ダウンロードページからWindows版インストーラーをダウンロードし、インストールします。
  2. コマンドプロンプトまたはPowerShellを開き、以下のコマンドでSalesforce組織に認証します。
# PowerShellの場合
    sf org login web -a <your_alias_name>
    
# コマンドプロンプトの場合
    sf org login web -a <your_alias_name>

このコマンドを実行するとブラウザが開き、Salesforceのログイン画面が表示されます。ログインが成功すると、コマンドラインに認証完了のメッセージが表示されます。

ステップ2: デバッグログの有効化と取得

問題発生時に詳細なログを記録するように設定し、ログを取得します。以下のコマンドは、特定のユーザーのデバッグログレベルを設定し、そのログを取得する例です。

# ログレベルの設定（ここではDEVELOPER_NAMEを、CPUエラーが発生しているユーザー名に置き換えてください）
    # DEBUGログは非常に詳細でパフォーマンスに影響を与える可能性があるため、原因特定後には必ず無効にしてください。
    sf apex trace set -u <your_alias_name> --debug-level <DEVELOPER_NAME> --apex-code FINEST --apex-profiling FINEST --db FINEST --system FINEST --visualforce FINEST --workflow FINEST --expiration-hours 0.5 # 30分間ログを有効にする例

    # ログ取得後、最新のデバッグログを表示
    sf apex get log -u <your_alias_name> --latest
    
# コマンドプロンプトの場合
    sf apex trace set -u <your_alias_name> --debug-level <DEVELOPER_NAME> --apex-code FINEST --apex-profiling FINEST --db FINEST --system FINEST --visualforce FINEST --workflow FINEST --expiration-hours 0.5

    sf apex get log -u <your_alias_name> --latest

取得したログの中から「LIMIT_USAGE_FOR_NS」や「CALLS_LIMIT」などのセクションを確認し、どのApexクラス、トリガー、メソッドがCPU時間を多く消費しているかを特定します。特に「Cumulative CPU time」の項目に注目してください。

一時的な対処のヒント:

  • **問題のトリガー/フローの一時的な無効化:** デバッグログから特定のトリガーや自動化されたフローが原因であると特定できた場合、Salesforceのセットアップメニューから一時的に無効化することで、緊急事態を回避できる場合があります。ただし、これは業務影響を考慮した上で慎重に行ってください。
  • **データ量の削減:** もし特定のデータ処理で発生している場合、一時的に処理対象のデータ量を減らす（例: フィルター条件を追加する）ことで、エラーを回避できる可能性があります。

3. Salesforce: Apex CPU time limit exceeded が発生する主要な原因（複数）

このエラーは通常、以下のいずれか、または複数の原因が複合的に絡み合って発生します。

  • **非効率なループ処理:**
    • ループ内でSOQLクエリやDML操作（insert, update, delete）を実行している（「N+1クエリ」問題）。
    • ネストされたループ（多重ループ）で大量のデータを処理している。
  • **大量データ処理:**
    • 一度に処理するレコード数が非常に多い場合、その処理ロジックが最適化されていないとCPU時間を消費しやすい。
  • **複雑なSOQLクエリ:**
    • SELECT句で多くの項目を取得している。
    • WHERE句の条件が複雑すぎる、またはインデックスが適切でない項目を使用している。
    • 外部オブジェクトへの参照が多い場合。
  • **トリガーやワークフロー、フローの連鎖（Recursive Triggers）:**
    • あるオブジェクトの更新が別のオブジェクトの更新を呼び、それがさらに別の処理を呼び出すなど、無限ループに近い連鎖が発生している。
    • トリガーやフローが多すぎ、一つの操作で多くの自動化が実行されている。
  • **ガバナ制限の認識不足:**
    • Salesforceのガバナ制限（特にSOQLクエリ数、DML操作数、CPU時間）を十分に理解せず、大規模な処理を同期Apexで実行しようとしている。

4. Salesforceで恒久的に再発を防ぐには

一度「Apex CPU time limit exceeded」エラーが発生した組織では、根本原因を解決し、将来的に再発を防ぐための対策を講じることが不可欠です。以下に具体的な対策を挙げます。

  1. **SOQL/DMLの最適化（一括処理）:**
    • ループ内でのSOQLクエリやDML操作を避け、ループの外で一括して実行するように修正します（例: SOQLはSet/Mapを使って必要なデータを一度に取得し、DML操作もListでまとめて行う）。
    • WHERE句を適切に使用し、取得するレコード数を最小限に抑えます。
    • 効率的なクエリのために、カスタムインデックスの利用も検討します。
  2. **ループ処理の改善:**
    • SetやMapを積極的に活用し、コレクションに対する効率的な検索・更新を行います。
    • 不必要なネストされたループを避けます。
  3. **非同期処理の活用:**
    • 大量データ処理や時間のかかる処理は、同期Apexではなく、非同期Apex（@futureメソッド、Queueable Apex、Batch Apex）を利用して実行します。非同期処理は、同期Apexとは異なるガバナ制限が適用され、CPU時間の制限も緩やかになります。
  4. **トリガーハンドラーフレームワークの導入:**
    • トリガーロジックをクラスに分離し、フレームワークを利用することで、トリガーの複雑性を管理し、再帰処理を防ぎやすくなります。
    • トリガーを1オブジェクト1トリガーの原則で運用し、処理はクラスに委譲します。
  5. **コードレビューとパフォーマンステスト:**
    • 新しいApexコードや既存コードの変更時には、必ずコードレビューを行い、ガバナ制限を意識した効率的なコードになっているか確認します。
    • 本番環境へのデプロイ前に、十分な量のテストデータを用いたパフォーマンステストを実施し、CPU時間制限に抵触しないことを確認します。
  6. **開発者コンソールやVS Codeでのプロファイリング:**
    • Salesforceの開発者コンソールやVS Codeの拡張機能（Apex Replay Debuggerなど）を活用し、コードの実行プロファイルを確認してボトルネックを特定します。

これらの対策を講じることで、「Apex CPU time limit exceeded」エラーの再発を防ぎ、Salesforce組織の安定性とパフォーマンスを向上させることができます。

 

Related Posts