Loading

Data Loader 中的常見錯誤訊息

發佈日期: Nov 4, 2025
描述

以下列出當您使用 Data Loader 更新或插入記錄時會收到的常見 Data Loader 錯誤。

解決方案

 

錯誤:資料列大於標頭

原因:欄位中的資料沒有標頭可對應。

解決方案:檢閱每個資料欄,並確定標頭已存在。請注意:檢閱資料集下方數欄與列,因為極端值儲存格可能意外包含資料。
 

 

錯誤:物件識別碼的存取權不足/交互參照識別碼的存取權不足

請檢閱設定 Data Loader以瞭解更多

原因:執行動作的使用者沒有正在參照之記錄或物件的存取權。例如:

  • 您正在參照的記錄已遭刪除
  • 參照從未存在的記錄 (例如,因為記錄識別碼欄位中的錯字)
  • 您參照的記錄存在,但並未與您要插入或更新之記錄的記錄擁有者共用。
  • 您參照的記錄存在,但未與執行插入或更新的使用者共用
  • 您沒有被指派至該記錄之記錄類型的存取權


解決方案:將 Data Loader 批次大小減少到 1,以找出有問題的列。檢查包含識別碼的每個資料欄執行個體是否有受影響的資料列,方法是透過在瀏覽器 URL 中的 .com/ 之後貼上識別碼,以在 Salesforce 中開啟相關記錄。請注意:某些識別碼,例如 Lightning 中的記錄類型或物件,有唯一的 URL。在這些情況下,請先在使用者介面中開啟類似的記錄,以建構適當的 URL。


 

錯誤:發現重複的值

原因:使用者正嘗試更新唯一欄位。請參閱使用 Data Loader 更新記錄時發生「找到重複的值」錯誤,以取得詳細資料。

解決方案:將批次大小減少為 1,以找出檔案中有問題的資料列。開啟目標物件的設定區段,在設定中檢閱在 Data Loader 作業中對應的每個欄位 (資料欄),並找出其唯一屬性已選取的欄位。使用 Data Loader 來查詢包含重複值的記錄,以在您的檔案中找出重複記錄的受影響欄位值,並進行調整。


 

錯誤:記錄類型不正確的識別碼值

原因:輸入的記錄類型必須是識別碼,而非名稱。

解決方案:檢閱您檔案的記錄類型值,並輸入對應的記錄類型識別碼。請參閱尋找記錄類型的識別碼,以取得詳細資料。另請檢閱《SOAP API 開發人員指南》以瞭解 RecordType

 

錯誤:java.lang.OutOfMemoryError:Java 堆積空間

原因:Java 在您嘗試執行資料載入作業的本機電腦上已耗盡記憶體資源。

解決方案:請參閱 Data Loader 中發生「Java 堆積空間」錯誤,以取得詳細資料。


 

錯誤:擁有者識別碼:類型不正確的識別碼值:

原因:

  • 輸入的記錄擁有者必須是識別碼,而非名稱。
  • 在相關記錄的「對應」欄位中,如果指定的識別碼值是針對不同物件,此錯誤也會持續存在。


解決方案:

  • 找出受影響的資料列,並以其識別碼取代使用者名稱。請參閱尋找 Salesforce 使用者識別碼以取得詳細資料。
  • 將識別碼取代為正確物件其正確記錄的識別碼。


 

錯誤:System.Exception:過多 SOQL 查詢

原因 1:物件上的觸發程序超出 Apex 管理員限制。

原因 2:批次大小設定為較大數字。嘗試將批次大小減少到 1,以便逐一處理。

解決方案:減少批次大小有助於減緩問題,但應與開發人員合作進行長期修正,以設定偵錯記錄來找出有問題 Apex 進行審查,並大量處理您的程式碼

 

錯誤:由於批次錯誤而未處理:無效的批次:無法剖析 CSV 標頭

原因:只有在已啟用「使用大量 API」時才會發生此錯誤。

解決方案:確定至少已對應一個欄位,或者未略過欄位對應步驟。如需詳細資訊,請參閱「定義 Data Loader 欄位對應」。


 

錯誤:只有插入記錄時必須對應名稱欄

原因:當在 csv 檔案中未包含「名稱」標準欄位 (針對有問題的物件) 時,會發生這種情況。

解決方案:在您的檔案中包含「名稱」欄,指定每個記錄的名稱,並在插入時對應名稱。


 

錯誤:無效的 CSV 檔案格式。請選取其他檔案。讀取列號時發生錯誤:資料欄的數量超過標頭中的資料欄數量。

原因:Data Loader 34.0 導入了使用逗號或 Tab 分隔 CSV 檔案的功能。如果逗號分隔的檔案在至少一個儲存格內包含 Tab 字元,則 Data Loader 會將該 Tab 字元視為額外的資料欄。

解決方案:使用文字編輯器編輯檔案,將有問題的儲存格以引號括住。範例:"123 Main St."


 

錯誤:無效的數字 (":無效的數字:")

原因:當以數字欄位為目標的儲存格 (匯入檔案) 包含逗號作為千位數分隔符號時,系統會傳回此錯誤。

解決方案:確定在匯入檔案中輸入的數字欄位值沒有逗號。在 Excel 中醒目提示包含逗號的數字資料,然後按下滑鼠右鍵並選取「設定儲存格格式...」,選擇數字索引標籤,然後選取「種類:數字」,並確定「使用千位數分隔符號 (,)」偏好設定未勾選。


 

錯誤:群組成員資格作業已在進行中

此錯誤會發生於您更新使用者角色資訊時,且如果您已設定共用規則,則不會更新記錄,因為每次更新單一記錄時,都會重新計算所有共用規則。

解決方案:

  • 進入「設定」,在「快速尋找」方塊中輸入「延後共用計算,然後選取「延後共用計算」。
  • 在「共用規則計算」相關清單中,按一下「暫停」。
  • 變更共用規則、角色、區域範圍或參與共用規則的公用群組。
  • 若要啟用共用規則計算,在完成變更後按一下「恢復」。


 

錯誤:AccountAfterInsert:AfterUpdate 執行

原因:觸發程序在「帳戶」物件上為使用中,導致 Apex 在您的資料作業期間失敗。

解決方案: 減少批次大小有助於減緩問題,但應與開發人員合作進行長期修正,以設定偵錯記錄來找出有問題 Apex 進行審查,並大量處理您的程式碼。 


 

錯誤:此使用者類型的作業無效

原因:當指派的使用者目前為非使用中時,會發生此錯誤。 

解決方案:再次檢查正在指派的「使用者」是否為「非使用中」。如果您嘗試編輯由非使用中使用者擁有的記錄,請考慮與系統管理員合作以啟用「建立稽核欄位」

請注意:上述為常見的錯誤。您遇到的錯誤可能不在清單中。



知識文章編號

000384437

 
正在載入
Salesforce Help | Article