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

展開時の DUPLICATE_USERNAME エラー

公開日: Aug 7, 2025
説明
変更セットを使用して展開を実行すると、次のエラーが表示される場合があります。

System.DmlException:Insert failed.First exception on row 0; first error:DUPLICATE_USERNAME, Duplicate Username.<br>Another user has already selected this username.<br>Please select another.: [Username]"Failure Stack Trace:"Class.DuplicationxxTest.DeDuplication: line x, column 1" 
 
解決策
推奨されている方法は、組織内の重複ユーザーを見つけるためのさまざまな方法のうちの 1 つです。組織に重複管理ルールを設定することで、組織のコンテキスト内でも重複ユーザーが作成されないようにする方法もあります。 
重複レコードの管理

ユーザー名はインスタンス間で共有されますが、環境間 (本番/サンドボックス) では共有されません。たとえば、サンドボックスインスタンスでユーザーアカウントのユーザー名が a@b.c の場合、他のサンドボックスインスタンス (CS*) ではこのユーザー名を使用できませんが、本番インスタンス (NA*、EU*、AP*) では使用できます。

テスト実行時の展開中に一意であることが強制されるため、同じ環境 (本番かサンドボックス) の別の組織にユーザー名が登録済みの場合、挿入コールは失敗します。テストに保証済みの一意のユーザー名を使用することでこれを解決できます。以下のコードスニペットのように、組織 ID + タイムスタンプ + ランダムな値など、グローバルで一意のユーザー名を生成することが推奨されています。
 
public static User createTestUser(Id roleId, Id profID, String fName, String lName) {
    String orgId = UserInfo.getOrganizationId();
    String dateString = String.valueof(Datetime.now()).replace(' ','').replace(':','').replace('-','');
    Integer randomInt = Integer.valueOf(math.rint(math.random()*1000000));
    String uniqueName = orgId + dateString + randomInt;
    User tuser = new User(  firstname = fName,
                            lastName = lName,
                            email = uniqueName + '@test' + orgId + '.org',
                            Username = uniqueName + '@test' + orgId + '.org',
                            EmailEncodingKey = 'ISO-8859-1',
                            Alias = uniqueName.substring(18, 23),
                            TimeZoneSidKey = 'America/Los_Angeles',
                            LocaleSidKey = 'en_US',
                            LanguageLocaleKey = 'en_US',
                            ProfileId = profId,
                            UserRoleId = roleId);
    return tuser;
}

推奨されている方法は、組織内の重複ユーザーを見つけるためのさまざまな方法のうちの 1 つです。組織に重複管理ルールを設定することで、組織のコンテキスト内でも重複ユーザーが作成されないようにする方法もあります。 


 
ナレッジ記事番号

000385970

 
読み込み中
Salesforce Help | Article