一般 SPMT 問題和錯誤的疑難排解
本文說明使用 SharePoint 移轉工具 (SPMT) 時,您可能會遇到的一些常見問題和錯誤。
注意事項
如需 SPMT 安裝問題的說明,請參閱:對 SPMT 安裝問題進行疑難排解
常見錯誤訊息
訊息 | 執行此動作 |
---|---|
我們無法連線到您提供的網站 | 檢查清單是否存在,或您是否可以透過電腦在來源網站及目標網站中存取它。 確認您已使用可存取網站的帳戶登入 SPMT。 確認您輸入的 URL 正確,並遵循適當的格式。 範例: < 垃圾 >< 郵件 > HTTPs:// ><< 垃圾郵件 > contoso.sharepoint.com/teams/SiteTitle < 垃圾 >< 郵件> |
無效的來源資料夾 | 確認您輸入的路徑正確,並遵循正確的格式 確認 SPMT 的使用者具有資料夾的讀取權限。 |
無法建立或更新網站 | 確認您具有建立網站的許可權,且 URL 有效 。如果網站存在,請確認您是網站集合系統管理員 。如果仍然失敗,請手動建立網站,並將移轉工具指向這個新建立的網站。 |
掃描檔案失敗:資料夾名稱無效 | 請參閱 OneDrive 和 SharePoint 中不正確檔案名和檔案類型。 |
掃描檔案失敗:目標路徑太長 | 請參閱 OneDrive 和 SharePoint 中不正確檔案名和檔案類型。 整個路徑,包括檔案名,必須包含少於 400 個字元的 OneDrive、OneDrive 和 SharePoint。 |
掃描檔案失敗:磁碟空間不足,無法封裝檔案 | 可供移轉工作資料夾使用的磁碟空間對您的來源檔案來說太小。 放大您工作資料夾的大小,然後再試一次。 |
封裝失敗:無法開啟檔案 | 由於非現有來源而造成封裝失敗。 檢查您是否可以存取來源根資料夾。 |
已建立重複的工作。 | 用來進行大量移轉的 CSV 檔案不能有重複的專案。 請移除重複的行,然後再試一次。 |
未移轉上層資料夾 | 父資料夾未移轉,因此資料夾下的所有專案都無法移轉。 檢查您的父資料夾,然後重試移轉。 |
任務 #,參數 1。 來源路徑不應該是空的 | 確認 CSV 檔案中的來源路徑欄具有值。 |
任務 #,參數 4。 目標 URL 是不正確 URL | 確認 CSV 檔案中的目標 URL 欄具有值且有效。 |
任務 #,參數 5。 目標清單不應該是空的 | 確認 CSV 檔案中的目標清單欄具有值。 |
將此內容移轉到 OneDrive 需要系統管理員權限。 | 檢查用來移轉內容的帳戶是否具有目的地 OneDrive 的許可權。 |
SPMT 錯誤碼
錯誤碼 | 建議的動作 |
---|---|
0x0201000D | 檢查清單是否存在,或您是否可以在來源網站及目標網站中存取它。 |
0x02050008 | 無法存取您的本機儲存空間。 重新開始移轉。 |
0x02010023 | 不支援您的來源清單範本。 嘗試其他清單範本。 |
0x0201000C | 請檢查您的認證,然後重新輸入您的使用者名稱和密碼。 |
0x02010017 | 您必須是網站集合管理員。 |
0x02060009 | 1 - 無法建立網站集合,因為 URL 已在使用中或 URL 無效。 |
2 - 無法建立網站集合,因為 URL 包含不正確字元。 | |
3 - 無法建立或更新網站集合。 | |
0x02060007 | 1 - 無法建立網站集合,因為 URL 已在使用中或 URL 無效。 |
2 - 無法建立網站集合,因為 URL 包含不正確字元。 | |
0x02010018 | 1 - 請檢查您的認證,然後再試一次。 |
2 - 存取 SharePoint 時發生問題。 請檢查您的認證,然後再試一次。 | |
3 - 存取 SharePoint 時發生問題。 請檢查您的認證和網路連線,然後再試一次。 | |
4 - 存取 SharePoint 時發生問題。 請檢查您的認證和網站 URL 的正確性,然後再試一次。 | |
5 - 存取 SharePoint 時發生問題。 請檢查您的認證和 URL 格式。 請再試一次。 | |
6 - 存取 SharePoint 時發生問題。 請檢查您的認證,然後再試一次。 如果問題持續發生,請建立支援案例。 | |
7 - 存取 SharePoint 時發生問題。 請檢查您的認證,並試著在瀏覽器中開啟您的網站。 | |
0x0204000A | 無法建立套件檔案。 SPMT 工作資料夾 %appdata%\Microsoft\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。 重新開始移轉。 |
0x02030001 | 1 - 請檢查您的認證。 重新開始移轉。 |
2 - 請檢查您的認證。 重新開始移轉。 | |
3 - 請檢查您的認證和網路連線。 重新開始移轉。 | |
4 - 請檢查您的認證和您的網站 URL。 重新開始移轉。 | |
5 - 請檢查您的認證和 URL 格式。 重新開始移轉。 | |
6 - 請檢查您的認證,並重新開始移轉。 如果訊息持續存在,請建立支援案例。 | |
7 - 請檢查您的認證,並試著在瀏覽器中開啟您的網站。 重新開始移轉。 | |
0x02010008 | 請確認使用者對應檔案的路徑和格式,以及您是否有存取權限。 |
0x02050001 | SPMT 工作資料夾 %appdata%\Microsoft\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。 重新開始移轉。 |
0x02010002 | 請檢查您的網路狀態。 如果您可以從瀏覽器存取來源網站,請建立支援案例。 |
0x02010010 | 請確認來源清單和目標清單具有相同範本。 |
0x0204000D | 在移轉期間,SPMT 工作資料夾 %appdata%\Microsoft\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。 重新開始移轉。 |
0x02040012 | 您本機電腦上的暫時儲存空間太小。 SPMT 會在工作資料夾上快取套件。 擴充您的暫時儲存空間,然後重試。 |
0x02030003 | 具有唯一權限的項目太多。 透過減少唯一權限的數目,以簡化您的權限清單。 重試移轉。 |
0x02050001 | 本機儲存體檔案已經損毀。 在移轉過程中,已經處理或修改工作資料夾。 重試移轉。 |
0x02080001 | 套件中的檔案在上傳時遭到變更或刪除。 SPMT 工作資料夾 %appdata%\Microsoft\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。 重新開始移轉。 |
0x02010006 | 來源 SharePoint 網站沒有任何已定義的角色定義。 存取來源網站時,請檢查您的角色是否存在。 |
0x02040009 | 無法建立套件,因為找不到目錄。 SPMT 工作資料夾 %appdata%\Microsoft\MigrationToolStorage 中的所有檔案和資料夾都必須關閉。 重新開始移轉。 |
0x02010020 | 停用 SPMT 設定中的移轉版本歷程記錄,或啟用 SPO 中的版本設定。 |
0x0201000E | 檢查全域設定是否有篩選出目標路徑中的特殊字元,或是路徑是否有不支援的字元。 |
0x02010016 | 找不到您的 SharePoint Server 使用者。 請確定您是網站集合管理員。 |
0X0201000F | 無效的網站 URL。 檢查網站 URL 是否有效。 嘗試透過瀏覽器存取 URL。 |
0x0207001 | 您沒有工作資料夾的存取權。 檢查您是否可以存取 %appdata%\Microsoft\MigrationToolStorage。 |
0x01410010 | 由於清單項目的相依性遺失而導致失敗。 如需詳細資訊,請參閱 FailureSummaryReport.csv。 檢查是否已在您的移轉範圍中包含相依性。 |
0x01510001 | 無法上傳套件。 如果您已自訂 Azure 儲存體,請檢查您是否能夠存取 Azure 儲存體,並檢查您是否能夠存取目標網站。 嘗試再次移轉。 |
0x01510001 | 無法上傳工作到伺服器:上傳檔案在移轉期間失敗。 |
0x02070009 | 無法上傳數個套件。 請暫停工作並檢查您的網路連線。 |
0x01710009 | 由於工作端失敗而導致失敗;套件中的部分項目失敗。 重新開始移轉。 |
0x01710009 | 伺服器處理檔案時發生錯誤或逾時:未移轉套件中的所有項目。 |
0x01610001 | Azure 容器已過期。 重試移轉工作。 |
0x01710006 | 伺服器處理檔案時發生錯誤或逾時:工作嚴重錯誤。 |
0x01710004 | 伺服器處理檔案時發生錯誤或逾時。 無法查閱資料夾名稱。 項目可能存在於相同網站集合的其他清單或網站中。 或項目位於資源回收筒中。 |
0x0131000D | 無法取得所有清單專案版本;工具會將要求傳送至擷取專案版本,但不會傳回任何專案。 當一般檔案和 .aspx 檔案之間的下載連結不同時,就會發生此錯誤。 此案例已在 4.x 版中修正。 |
0x0131000F | 無法讀取檔案。 已取出檔案。 |
0x0111000A | 掃描檔案失敗: 檔案大小超過限制。 請參閱版本資訊:SharePoint 移轉工具瞭解目前限制。 |
導覽錯誤
錯誤 | 原因 | 動作 |
---|---|---|
這個導覽節點包含無效的 URL:找不到這個 URL 所指向的物件。 | SharePoint 會先驗證 URL,再建立導覽節點。 如果 URL 代表 SharePoint 物件,而且找不到物件,SharePoint 會拒絕節點建立查詢,並出現此錯誤。 如果在無法在目前工作中辨識 URL 對應的先前工作中刪除、移動、尚未移轉或移轉 URL 目標,則找不到物件。 | 在多個任務之間使用相同的 URL 對應。 例如: 工作 1:HTTP: domain/new_path/site //domain/original_path/site - > HTTP:// Task 2:HTTP://。 domain/new_path/site2 domain/original_path/site2 - > HTTP:// 執行另一項工作來移轉指向先前未移轉之物件的導覽節點。 已在目標網站中手動建立節點。 |
導覽設定已高度自訂。 目前不支援它。 | 只有在全域網站和目前的網站導覽值符合預先定義的範本時,才能進行移轉。 否則,此值會辨識為 高度自訂 且不會移轉。 | 將全域導覽和目前導覽變更為使用其中一個預先定義的範本。 請參閱 網站設定 - > 外觀和風格 - > 導覽。 手動編輯目標網站上的設定。 |
無法取得目標字詞組識別碼。 無法更新 Web 導覽設定的分類法提供者。 | 由於全域和/或目前的網站導覽設定設為 「受控導覽」,因此字詞庫掃描器無法取得目標字詞庫識別碼。 如果未正確設定受控中繼資料服務,字詞庫掃描器將無法取得目標字詞庫識別碼。 | 在 SPMT 受管理的中繼資料移轉中深入了解。 |
Web 導覽設定的分類法提供者字詞組識別碼無效。 | 當全域或目前的網站導覽設定設定為 「受控導覽」時,字詞庫掃描器無法對應字片語識別碼。 | 確認來源網站上的設定有效,且已成功移轉字詞組。 |
若要更新 Web 導覽設定,您需要下列權限:新增並自訂頁面。 | 用於移轉的 SharePoint 帳戶沒有編輯網站導覽設定的權限。 | 將 [新增並自訂頁面] 權限授與此帳戶。 |
分類法錯誤
錯誤 | 原因 | 動作 |
---|---|---|
由於權限問題,移轉字詞庫失敗。 | 使用者不是字詞庫管理員。 | 在 SharePoint 系統管理中心中,選取 [傳統功能],然後在 [字詞庫] 下,選取 [開啟]。 選取您要移轉的字詞庫,然後將目前的使用者新增為字詞庫系統管理員。 |
由於缺少工作語言,移轉字詞庫失敗。 | 並非來源字詞庫的所有工作語言都存在於目標字詞庫。 | 移至 SharePoint 網站設定。 在 [網站管理] 下,選取 [字詞庫管理]。 選取您要更新的字詞庫,選取並將來源字詞庫中現有的所有語言新增至目標工作語言面板。 |
由於預設的字詞庫不存在,移轉字詞庫失敗。 | SP 內部部署上沒有預設的網站集合字詞庫。 | 移至 SharePoint Server (內部部署) 管理中心,[應用程式管理] 下的管理服務應用程式,編輯 [Managed Metadata Service 連線] 的內容。 選取 [此服務應用程式是欄特定字詞組的預設儲存位置]。 |
由於存在多個預設字詞庫,移轉字詞庫失敗。 | SP 內部部署上存在數個預設網站集合字詞庫。 | 移至 SharePoint 內部部署管理中心,[應用程式管理] 下的管理服務應用程式,選擇一個 Managed Metadata Service 連線做為預設字詞庫。 取消選取其他 Managed Metadata Service 連線的 [此服務應用程式是欄特定字詞組的預設儲存位置]。 |
由於來源字詞不存在,移轉固定字詞失敗。 | 在某些情況下,固定字詞會位於全域字詞組中 (可供連線至此 Managed Metadata Service 應用程式的所有網站使用),而來源字詞則位於本機字詞組 (可供此網站集合的使用者使用)。 SPMT 會先移轉全域詞彙,然後移轉本機詞彙。 如果來源字詞位於本機集合中,且固定字詞位於全域集合中,則在 SPMT 嘗試移轉釘選的全域字詞之前,將不會移轉本機來源字詞。 | 因為來源本機字詞已在上一個動作中移轉,所以請再次移轉以包含釘選的全域字詞。 |
網頁組件錯誤
錯誤 | 原因 | 動作 |
---|---|---|
不支援移轉的網頁組件 | SPMT 目前不支援此網頁元件。 | 檢查目前支援的網頁元件清單: SPMT 支援的網頁元件。 |
移轉失敗,因為遺漏參考清單 | 清單尚未新增至工作清單。 | 檢查您的網頁元件和參考清單,以確保其位於您的移轉範圍中。 |
移轉失敗,因為正在自訂頁面 | SPMT 目前不支援自訂頁面移轉。 | 使用 SharePoint Designer 還原頁面的範本頁面,並重新開始您的移轉。 |
網頁組件移轉失敗,因為頁面移轉失敗 | 頁面以及該頁面上的所有網頁組件移轉失敗。 | 重新嘗試移轉失敗的頁面。 如果頁面成功,則該頁面上的所有網頁組件都會成功移轉。 |
移轉失敗,因為它是不安全的網頁組件,且伺服器設定 'NoScript' | 在目標 SharePoint 網站中開啟設定 NoScript 時,會將網頁組件視為不安全,因為網頁可能能夠執行 JavaScript 指令碼或其他程式碼。 網頁組件的移轉將遭到封鎖。 | 關閉目標 SharePoint 網站上的 NoScript 設定,以便將這些網頁元件解除封鎖。 重要:如果您關閉這些設定,您的網站可能會面臨風險。 如需詳細資訊,請 參閱允許或防止自訂腳本。 |
移轉失敗,因為 XML 定義無效 | XsltListView 網頁組件和 ListView 網頁組件包含的 XML 定義,對這些網頁組件的移轉非常重要。 有時候,由於升級問題或伺服器錯誤,XML 定義會無效。 | 從 SharePoint Server 來源頁面刪除失敗的網頁元件。 重新新增該組件,然後再次嘗試移轉。 |
移轉失敗,因為組件名稱無效 | 網頁組件的組件名稱對於讓 SPMT 移轉網頁組件非常重要。 如果無法從其 SOAP 回應剖析網頁元件的元件,則移轉會失敗。 | 檢查此網頁組件是否為支援的「立即可用」(OOTB) 網頁組件。 如果支援,請提出 Bug,我們將進行調查。 不過,如果網頁元件是協力廠商網頁元件,則不支援。 |
移轉失敗,因為網頁組件連線失敗。 | 網頁組件連線至移轉失敗的另一個網頁組件,導致這兩者都失敗。 | 請確定已成功移轉連線的網頁組件。 重試移轉。 |
移轉失敗,因為無法對應使用者 | 如果使用者欄位是網頁組件的屬性,SPMT 會嘗試將來源網頁組件上的使用者 (通常是內部部署使用者) 對應至目標 SharePoint 網站上的使用者。 當 SPMT 無法對應至使用者時,就會發生此錯誤。 | 確認Microsoft Entra識別碼用來將所有內部部署使用者同步至 SharePoint。 |