本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 故障診斷持久性儲存問題
<a name="troubleshooting-persistent-storage"></a>

Amazon WorkSpaces 應用程式支援下列持久性儲存的選項：主資料夾、Google Drive for G Suite 和 OneDrive for Business。由於這些持久性儲存解決方案的內容同步處理行為相同，因此建議您檢閱 [主資料夾內容同步](home-folders-content-synchronization.md) 以取得預期行為的相關資訊。

以下是您或您的使用者使用 WorkSpaces 應用程式持久性儲存時可能發生的問題。

**Topics**
+ [我堆疊的主資料夾無法正常運作。](#troubleshooting-s3-failures)
+ [我的使用者無法從我們的其中一個應用程式存取他們的主資料夾目錄。](#alternate-path-accessing-home-folders)
+ [我的使用者從我們的其中一個應用程式存取主資料夾時，會收到「裝置尚未就緒」錯誤訊息。](#alternate-path-accessing-home-folders)
+ [我移除或取代了 Amazon S3 中使用者主資料夾內的檔案，但我的使用者在串流工作階段期間，未在機群執行個體上其主資料夾中看見變更。](#removed-replaced-folder-in-s3-users-dont-see-changes-on-fleet-instance)
+ [持久性儲存未如預期執行。使用者的檔案儲存到持久性儲存的時間比預期更長。](#troubleshooting-persistent-storage-applications-take-long-time-to-save-to-home-folder)
+ [我的使用者收到錯誤，指出檔案已在使用中，但其檔案未在使用中。](#troubleshooting-persistent-storage-application-errors-files-already-in-use)
+ [當資料夾包含數千個檔案時，WorkSpaces 應用程式可能需要很長的時間才能顯示檔案清單。](#troubleshooting-persistent-storage-delay-listing-thousands-of-files-in-folder)

## 我堆疊的主資料夾無法正常運作。
<a name="troubleshooting-s3-failures"></a>

備份到 S3 儲存貯體的主資料夾可能會在下列案例中發生問題：
+ 串流執行個體未具備網際網路連線能力，或是無法存取私有 Amazon S3 VPC 端點 (若適用的話)。
+ 網路頻寬使用量過高。例如，使用者在服務嘗試將包含大型檔案的主資料夾備份到 Amazon S3 時下載或串流多個大型檔案。
+ 檔案大於 5 GB。
+ 管理員刪除了服務建立的儲存貯體。
+ 管理員未正確編輯 `AmazonAppStreamServiceAccess` 服務角色的 Amazon S3 許可。

如需詳細資訊，請參閱 [Amazon Simple Storage Service 使用者指南](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)。

## 我的使用者無法從我們的其中一個應用程式存取他們的主資料夾目錄。
<a name="alternate-path-accessing-home-folders"></a>

有些應用程式無法辨識在檔案總管中將主資料夾顯示為最上層資料夾的重新導向。若發生這種情況，您的使用者可以透過從應用程式界面選擇 **File Open (開啟檔案)** 並瀏覽到以下其中一個目錄，來在串流工作階段期間從應用程式內存取他們的主資料夾：
+ 非加入網域的 Windows 執行個體：C:\$1Users\$1PhotonUser\$1My Files\$1Home Folder
+ 加入網域的 Windows 執行個體：C:\$1Users\$1%username%\$1My Files\$1Home Folder
+ Linux 執行個體：\$1/MyFiles/HomeFolder

## 我的使用者從我們的其中一個應用程式存取主資料夾時，會收到「裝置尚未就緒」錯誤訊息。
<a name="alternate-path-accessing-home-folders"></a>

持久性儲存掛載會在使用者登入後發生，而且可能需要幾秒鐘的時間。如果您的應用程式在持久性儲存掛載完成之前嘗試從主資料夾存取檔案，可能會發生「裝置尚未就緒」錯誤。建議您在等待幾分鐘後再試一次。

若要避免此問題，您可以使用工作階段指令碼並監控儲存體掛載狀態。然後，在掛載完成後啟動串流工作階段。這也會改善最終使用者的體驗。如需詳細資訊，請參閱[使用工作階段指令碼來管理 Amazon WorkSpaces 應用程式使用者的串流體驗](use-session-scripts.md)。

## 我移除或取代了 Amazon S3 中使用者主資料夾內的檔案，但我的使用者在串流工作階段期間，未在機群執行個體上其主資料夾中看見變更。
<a name="removed-replaced-folder-in-s3-users-dont-see-changes-on-fleet-instance"></a>

儲存在 S3 儲存貯體中使用者主資料夾內的內容，與串流工作階段期間機群執行個體上對使用者提供的內容，兩者之間可能因為儲存在 Amazon S3 儲存貯體中的主資料夾內容與儲存在 AppStream 2.0 機群執行個體上的主資料夾內容同步處理的方式而出現差異。

在使用者的 WorkSpaces 應用程式串流工作階段開始時，WorkSpaces 應用程式會為您的 Amazon Web Services 帳戶和區域編目存放在 Amazon S3 儲存貯體中的使用者主資料夾檔案。當使用者使用串流應用程式開啟其機群執行個體上主資料夾中的檔案時，AppStream 2.0 會將該檔案下載到機群執行個體。

使用者在作用中串流工作階段期間對機群執行個體上的檔案所做的變更，每隔幾秒就會上傳到 S3 儲存貯體中的主資料夾，或在使用者串流工作階段結束時上傳至主資料夾。

如果使用者在串流工作階段期間於機群執行個體上開啟主資料夾中的檔案，然後在未進行任何變更或儲存檔案的情況下關閉該檔案，而且您在串流工作階段期間從 S3 儲存貯體中該使用者的主資料夾內移除該檔案，則該檔案會在使用者重新整理資料夾後，從機群執行個體移除。如果使用者修改檔案並將檔案儲存在本機上，則在目前串流工作階段期間，該檔案仍會在機群執行個體上對使用者提供。檔案也會再次上傳至 S3 儲存貯體。但是，在下一個串流工作階段期間，該檔案不一定會在機群執行個體上對使用者提供。

檔案是否會在使用者下一個串流工作階段期間於機群執行個體上提供，取決於使用者在機群執行個體上變更檔案的時間早於或晚於您在 S3 儲存貯體中變更檔案的時間。

如需詳細資訊，請參閱[主資料夾內容同步](home-folders-content-synchronization.md)。

## 持久性儲存未如預期執行。使用者的檔案儲存到持久性儲存的時間比預期更長。
<a name="troubleshooting-persistent-storage-applications-take-long-time-to-save-to-home-folder"></a>

在 WorkSpaces 應用程式串流工作階段期間，將與運算密集型應用程式相關聯的大型檔案和目錄儲存至持久性儲存可能需要比儲存基本生產力應用程式所需的檔案和目錄更長的時間。例如，應用程式儲存大量資料或經常修改相同檔案所需的時間，可能會比儲存執行單一寫入動作的應用程式所建立的檔案更久。儲存許多小檔案也可能需要較長的時間。

如果您的使用者儲存與運算密集型應用程式相關聯的檔案和目錄，且 WorkSpaces 應用程式持久性儲存選項未如預期執行，建議您使用伺服器訊息區塊 (SMB) 解決方案，例如 Amazon FSx for Windows File Server 或 AWS Storage Gateway 檔案閘道。以下是與運算密集型應用程式相關聯的檔案和目錄範例，這些應用程式較適合搭配這些 SMB 解決方案使用：
+ 整合式開發環境 (IDE) 的工作區資料夾
+ 本機資料庫檔案
+ 圖形模擬應用程式建立的草稿空間資料夾

如需詳細資訊，請參閱：
+  [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/what-is.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/what-is.html)
+ [搭配 Amazon WorkSpaces 應用程式使用 Amazon FSx ](https://aws.amazon.com/blogs/desktop-and-application-streaming/using-amazon-fsx-with-amazon-appstream-2-0/)
+ 《AWS Storage Gateway 使用者指南》**中的[檔案閘道](https://docs.aws.amazon.com/storagegateway/latest/userguide/StorageGatewayConcepts.html#file-gateway-concepts)

**注意**  
在繼續進一步故障診斷之前，請先確認您的使用者在儲存檔案和目錄時遇到的問題僅與 WorkSpaces 應用程式持久性儲存相關聯，而不是與另一個原因相關聯。若要排除其他原因，請讓您的使用者嘗試將檔案或目錄儲存至其串流執行個體上可用的 Temporary Files 目錄。

## 我的使用者收到錯誤，指出檔案已在使用中，但其檔案未在使用中。
<a name="troubleshooting-persistent-storage-application-errors-files-already-in-use"></a>

此行為通常會在下列情況下發生：
+ 使用者的檔案最後一次儲存之後仍在上船 
+ 經常修改的檔案 (例如，資料庫檔案)

大型檔案上傳可能需要相當長的時間。此外，每次嘗試上傳檔案都可能會導致另一次檔案更新，進而導致重複嘗試上傳檔案。

若要解決此問題，建議您使用伺服器訊息區塊 (SMB) 解決方案，例如 Amazon FSx for Windows File Server 或 AWS Storage Gateway 檔案閘道。如需詳細資訊，請參閱：
+  [https://docs.aws.amazon.com/fsx/latest/WindowsGuide/what-is.html](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/what-is.html)
+ [搭配 Amazon WorkSpaces 應用程式使用 Amazon FSx ](https://aws.amazon.com/blogs/desktop-and-application-streaming/using-amazon-fsx-with-amazon-appstream-2-0/)
+ 《AWS Storage Gateway 使用者指南》**中的[檔案閘道](https://docs.aws.amazon.com/storagegateway/latest/userguide/StorageGatewayConcepts.html#file-gateway-concepts)

## 當資料夾包含數千個檔案時，WorkSpaces 應用程式可能需要很長的時間才能顯示檔案清單。
<a name="troubleshooting-persistent-storage-delay-listing-thousands-of-files-in-folder"></a>

WorkSpaces 應用程式使用 API 呼叫來擷取存放在 WorkSpaces 應用程式持久性儲存中的資料夾內容。每次 API 呼叫執行時可擷取的項目數設有限制。因此，如果 WorkSpaces 應用程式必須在單一資料夾中擷取數千個檔案，則可能需要比在包含較少檔案的資料夾中顯示檔案清單更長的時間來顯示所有檔案的清單。

若要解決此問題，如果您的一個資料夾中有數千個檔案，建議您將此內容分成少數幾個檔案群組，並將每個群組儲存在不同的資料夾中。這樣做可減少顯示每個資料夾中檔案清單所需的 API 呼叫次數。