Loading
Salesforce から送信されるメールは、承認済ドメインからのみとなります続きを読む

エラー: 「Duplicate value found: uuid__c duplicates value on record with id: 00XXXXXXXXXXXXX (値が重複しています: uuid__c duplicates の値が重複しているレコードの ID: 00XXXXXXXXXXXXX)」

公開日: Oct 27, 2025
説明
node.js や javascript などの言語を使用して Salesforce に継続的な REST API 呼び出しを送信する場合、一意の値のみを受け付ける外部 ID 項目を使用した REST による PATCH 呼び出しで、以下のエラーが発生することがあります。

Error: "duplicate value found: uuid__c duplicates value on record with id:00XXXXXXXXXXXXX" (エラー: 「値が重複しています: uuid__c duplicates の値が重複しているレコードの ID: 00XXXXXXXXXXXXX」)

既存のレコードを更新したり、新しいレコードを挿入したりするパッチ操作を行っているときに、なぜ重複エラーが発生するのでしょうか。

エラー自体にはいくつかの情報が含まれています。一方のレコードがすでに存在している、または処理されている間に、重複レコードを送信していることになります。

以下のようなシナリオになります。 

複数のリクエストが送信されることになるため、リクエストが重複する可能性があります。つまり、同じレコードが同時、またはミリ秒単位の差で送信された場合、最初のレコードが処理されている間に、2 番目のレコードが取り込まれて処理される可能性があります。その後、サーバーは 2 番目のレコードを重複と判断し、エラーをスローします。
解決策
このシナリオの最善の解決策は、リクエストを同期させることです。
  • 1 つのリクエストまたはリクエストのバッチに存在するレコードが 1 つのみであることを確認します。
  • Salesforce では連続するリクエストの間にタイムギャップは設定されていませんが、2 つのリクエストの間にミリ秒単位のタイムギャップを持たせるようにリクエストをプログラムすることをお勧めします (同じレコードで複数のリクエストが送信される場合)。
ナレッジ記事番号

000383480

 
読み込み中
Salesforce Help | Article