Japan Server Error Fix Lab

ホーム / Salesforce / Salesforce

Salesforce INVALID_CROSS_REFERENCE_KEY 遅延・負荷・タイムアウト

Salesforce で INVALID_CROSS_REFERENCE_KEY が発生した時に、遅延・負荷・タイムアウト の観点で原因、出力例、分岐対応、避ける操作を整理します。

lowINVALID_CROSS_REFERENCE_KEY6 分で読む
最初の確認コマンド
grep -R "INVALID_CROSS_REFERENCE_KEY" ./logs
最初に見る証拠

INVALID_CROSS_REFERENCE_KEY は「遅延・負荷・タイムアウト」として確認します。最初に見る証拠は latency, worker saturation, connection pools, locks, and long-running jobs です。

検索クエリ
Salesforce INVALID_CROSS_REFERENCE_KEYSalesforce error INVALID_CROSS_REFERENCE_KEYSalesforce INVALID_CROSS_REFERENCE_KEY 遅延・負荷・タイムアウト

この状況で発生します

The issue appears during traffic spikes, exports, batch jobs, or slow queries. 画面上の文言だけで判断せず、まず latency, worker saturation, connection pools, locks, and long-running jobs を確認し、正常出力と失敗出力を比較します。

症状チェック

  • INVALID_CROSS_REFERENCE_KEY が Salesforce の画面またはログで繰り返されます。
  • profile, permission set, flow, trigger, owner state が正常ケースと失敗ケースで異なります。
  • data permission issue from Apex/Flow automation issue を分けた時だけ問題が見えます。
  • リリース、権限、設定、データ更新の直後に起きやすいです。

可能性が高い原因

  • authorization failure caused by missing role, stale owner, key mismatch, inherited deny, WAF policy, or object-level permission.
  • 遅延・負荷・タイムアウト では latency, worker saturation, connection pools, locks, and long-running jobs が最初の手掛かりです。
  • 正常ケースと失敗ケースを比較しないと原因候補が広がりすぎます。
  • キャッシュ、権限、ネットワーク、プロキシ状態が一部ユーザーだけ違って見えることがあります。

1分で先に確認

  1. 初回発生時刻、直近変更、影響ユーザー、URL、オブジェクトIDを記録します。
  2. 正常/失敗ケースで profile, permission set, flow, trigger, owner state を同じ時間帯に比較します。
  3. 仮説を確認します: authorization failure caused by missing role, stale owner, key mismatch, inherited deny, WAF policy, or object-level permission.
  4. 遅延・負荷・タイムアウト かを判断します: latency, worker saturation, connection pools, locks, and long-running jobs.
  5. 設定変更前に現在値を保存します。

最初に見る証拠

INVALID_CROSS_REFERENCE_KEY は「遅延・負荷・タイムアウト」として確認します。最初に見る証拠は latency, worker saturation, connection pools, locks, and long-running jobs です。

出力例

正常出力

Connect, first byte, and total time stay within the expected budget.

失敗出力

Connect time, first byte time, or total time spikes before the error.

出力別の判断

  • The issue appears during traffic spikes, exports, batch jobs, or slow queries.
    Find whether the delay is network connection, upstream processing, database lock, or worker exhaustion.
  • 正常ケースと失敗ケースの出力が違います。
    差分が出たレイヤーで先に対応します: For INVALID_CROSS_REFERENCE_KEY, apply the fix only after reproducing the same condition and saving the before/after evidence for this exact code.
  • コマンドは正常でもユーザー画面だけ失敗します。
    キャッシュ、Cookie、権限、ネットワーク位置を分けて確認します。

避ける操作

  • Do not only raise timeouts while the synchronous workload remains unchanged.
  • 原因レイヤーを確認する前に複数設定を同時変更しないでください。
  • データ削除、広い権限付与、全面的なセキュリティ無効化を初動対応にしないでください。

検証状態

自動生成ドラフト: コード別の原因、コマンド、出力分岐、避ける操作を含みます。公式ドキュメントと実運用検証は継続して補強します。

先に実行するコマンド

grep -R "INVALID_CROSS_REFERENCE_KEY" ./logs
sfdx force:user:display
sfdx force:apex:log:list
sfdx force:data:soql:query -q "SELECT Id FROM User LIMIT 1"
grep -R "INVALID_CROSS_REFERENCE_KEY" force-app
grep -R "permission\|denied\|forbidden\|AccessDenied\|403" ./logs
whoami
ls -la
ssh -v [email protected]
curl -w 'connect=%{time_connect} start=%{time_starttransfer} total=%{time_total}\n' -o /dev/null -s https://example.com

解決順序

  1. INVALID_CROSS_REFERENCE_KEY の全文、失敗URL、ユーザー、オブジェクトID、直近変更を記録します。
  2. authorization failure caused by missing role, stale owner, key mismatch, inherited deny, WAF policy, or object-level permission に合う証拠を先に集めます。
  3. 失敗ケースと正常ケースを同じコマンドで比較します。
  4. 遅延・負荷・タイムアウト の分岐なら Find whether the delay is network connection, upstream processing, database lock, or worker exhaustion.
  5. 同じURLと同じコマンドで再検証し、正常出力を記録します。

原因別の対応

  • For INVALID_CROSS_REFERENCE_KEY, apply the fix only after reproducing the same condition and saving the before/after evidence for this exact code.
  • Identify the actor, target object, action, and policy that denied the request.
  • Restore ownership or grant the smallest required permission.
  • Refresh keys, signatures, sessions, or role assumptions.
  • Remove conflicting deny rules before adding broad allow rules.
  • Verify using the affected account, not an administrator session.
  • 遅延・負荷・タイムアウト の分岐では Find whether the delay is network connection, upstream processing, database lock, or worker exhaustion.

検証メタ

  • operator-draft
  • official-reference-linked
  • 2026-07-23

更新キュー

  • 更新周期
    weekly-source-review
  • 次の補強
    Add one official-source check and one real output example for Salesforce INVALID_CROSS_REFERENCE_KEY.

環境別の確認ポイント

  • 共有ホスティング、プロキシ、VPN、CDN は data permission issue from Apex/Flow automation issue の結果を変えることがあります。
  • Salesforce の管理画面だけでなくコマンド出力と比較します。
  • 日本のホスティング管理画面は完了表示でも DNS/SSL 反映が遅れることがあります。
  • 社内ネットワークと外部ネットワークの両方で確認します。

再発させないために

  • profile, permission set, flow, trigger, owner state の正常出力例を保存します。
  • owner activation, permission sets, validation rules, trigger order をリリースチェックリストに追加します。
  • 繰り返されるエラーは同じ形式の対応ノートに残します。
  • エラー率、遅延、証明書、ディスク、権限変更のアラートを分けます。