磚、快顯通知以及徽章通知的疑難排解 (Windows 執行階段應用程式)
[ 本文的目標對象是撰寫 Windows 執行階段 App 的 Windows 8.x 和 Windows Phone 8.x 開發人員。如果您正在開發適用於 Windows 10 的 App，請參閱 最新文件 ]
本主題討論當您遇到與磚、快顯通知以及徽章通知相關的問題時 (包含各種通知方法：本機、推播、定期和排程通知)，應該採取的初始疑難排解步驟。
疑難排解磚通知
本節可解決您在使用磚與磚範本時可能遇到的一些常見錯誤。除非另有指定，否則每個解決方案都適用於所有通知傳遞類型：本機、排程、定期或推播通知。
無法顯示本機磚通知
此情況中最常見的問題是用來定義通知的 XML 有某些地方不正確。不過，還是有其他可能的原因，這些步驟也會逐步引導您：
- 檢查使用者設定
- 在應用程式資訊清單中提供寬標誌或大標誌資源
- 檢查影像大小
- 驗證您的 URL
- 檢查您的影像格式
- 檢查您的 XML 的語法
- 檢查通知的到期時間
- 確定您已經啟用通知佇列
檢查使用者設定
可能的原因：使用者或系統管理員停用了通知。檢查應用程式是否在應用程式列提供 [開啟/關閉動態磚] 選項，且該選項並未設為 [關閉]。至於系統管理員，有數個群組原則可以停用通知。洽詢您的系統管理員，確定已啟用通知。
修正：透過應用程式列啟用通知，或請系統管理員透過群組原則啟用通知。
如需詳細資訊，請參閱 TileUpdater.setting。
在應用程式資訊清單中提供寬標誌或大標誌資源
可能的原因：應用程式資訊清單並未針對通知中指定的磚大小指定預設磚資源影像。例如，如果未提供預設的寬形磚影像，磚就永遠不會顯示寬格式的通知範本。在理想的情況下，磚通知應該在通知承載中為所有可能的磚大小提供範本，因為除非磚有意只使用中型影像，否則傳送者永遠不會知道當通知到達時會顯示哪一個磚大小。該設定完全由使用者自行決定。
修正：在通知承載中，提供您在資訊清單所提供的每種預設標誌影像的更新版本。具備預設標誌影像的磚可以任意調整大小。
檢查影像大小
可能的原因：通知中的每個影像大小都必須小於 1024 x 1024 像素，而且小於 200 KB。如果通知中的影像超過任何這些尺寸，將會捨棄通知。
修正：縮小影像。
如需詳細資訊，請參閱磚與快顯通知影像大小。
驗證您的 URL
可能的原因：URL 語法錯誤。
通知中的影像可透過資源參照或文字路徑來指定。如果使用路徑，必須使用三種通訊協定的其中一個來指定：
| 首碼 | 用途 | 附註 |
|---|---|---|
| http:// 和 https:// | 線上儲存的影像 | 這些影像可以由本機快取，因此影像伺服器可能不會收到影像要求。查詢字串可能會附加至這些 URL 中。如果選擇忽略查詢字串，請確定網頁伺服器傳回原始影像而不是 404。查詢字串範例：?scale=100&contrast=blk&lang=en-US 請注意，若要從網際網路抓取任何通知內容，您的應用程式必須在其應用程式資訊清單中宣告「網際網路 (用戶端)」功能。 |
| ms-appx:/// | 包含於應用程式套件中的影像 | 這些影像是您應用程式安裝的一部分。請注意，此參照在冒號後需要三斜線。在三斜線後面，統一資源識別元 (URI) 接受斜線 (/) 或反斜線 (\) 來分隔路徑中的資料夾，但是大部分的程式設計語言要求您在指定反斜線 (\\) 時使用逸出字元。 |
| ms-appdata:///local/ | 應用程式將影像儲存在本機 | 此位置會對應 Windows.Storage.ApplicationData.current.localFolder 傳回的資料夾。請注意，此參照在冒號後需要三斜線。路徑中資料夾的分隔符號必須使用逸出字元 (\\)。 |
注意 '/' 字元在每個規則類型中都做為分隔符號。建議您都使用 '/' 而不是 '\'，以避免使用逸出字元時產生的混淆。
正確格式範例：
| URL |
|---|
| https://www.contoso.com/icon.jpg |
| ms-appx:///images/icon.png |
| ms-appdata:///local/myDrawing.jpg |
錯誤格式範例：
| URL | 附註 |
|---|---|
| https://www.contoso.com\fail.png | HTTP 路徑必須使用 / 字元。請勿使用 \ 字元。 |
| http:www.contoso.com | HTTP 路徑在冒號後需要雙斜線 (//)。 |
| "ms-appdata:///local/c:\\images\\Drawing.jpg" | 應用程式無法參照其本機存放區外的影像。 |
| "ms-appx://images/triangle.png" | "ms-appx:" 中請使用三斜線而不是雙斜線。 |
檢查您的影像格式
可能的原因：不支援的影像格式。
通知僅能使用 .gif、.png 或 .jpg/.jpeg 格式的影像。影像的格式必須也要與其副檔名相符。只是將不支援的檔案類型重新命名為支援的副檔名沒有用。
影像格式錯誤最常見的原因是將點陣圖序列化至 Windows.Storage.ApplicationData.current.localFolder 存放區。務必使用您慣用的格式，否則影像會儲存為 Windows 點陣圖，且其標頭將會包含 "BMP" — 這是不支援的類型。
驗證：首先，確認您可以順利傳送僅文字的通知，將問題範圍縮小到影像。驗證影像格式的其中一種方式，是將影像載入至影像處理程式並儲存為 .jpg。如果您在通知中參照這個新的 .jpg 檔案且錯誤沒有重覆出現，就表示可能有影像格式錯誤。您也可以在 Microsoft Visual Studio 二進位編輯器中開啟這個檔案來檢查其標頭。
修正：變更或修正影像格式。
檢查您的 XML 語法和內容
可能的原因：XML 語法或驗證錯誤。
除了基本語法之外，請確認您的 XML 完整且正確，尤其是當您在不使用 API 或 NotificationsExtensions 程式庫的狀況下，將承載建構為字串的時候。XML 內容的一些常見錯誤包括：
- 區分大小寫。標記名稱、屬性名稱以及屬性值都有大小寫之分。確定您的 XML 的大小寫是正確的。
- 必須為每種磚大小提供 binding 元素。您應該針對所傳送的每個通知中支援的每個磚大小 (也就是您在資訊清單中提供的標誌影像) 分別提供 binding 元素。
- 文字字串不可以包含保留的 XML 字元。例如，您不可以使用 <i> 和 </i> 標記，將磚字串設定為斜體。如果您想要顯示文字字元 "<i>"，則應該適當地逸出。如需 XML 中逸出字元的詳細資訊，請參閱 XML 字串實體與 XAML。
- 針對 lang 屬性提供的值必須符合 ITEF BCP 47 規格。
- 在本機建立的 XML 字串 (針對本機或排程通知) 必須使用 UTF-16 編碼。如果字串透過推播通知傳送或從 URL 輪詢，則應該使用 UTF-8 編碼。
- 如果在具有非空白 src 屬性的 XML 承載中包含 image 元素，也必須包含有效影像的參照，否則將捨棄通知。
如果磚通知無法顯示，可以使用事件記錄檔來檢查是否有錯誤。若要在事件檢視器查詢磚通知的相關事件，請前往 [應用程式及服務記錄檔] > [Microsoft] > [Windows] > [Apps] > [Microsoft-Windows-TWinUI/Operational]。
驗證：使用 XML 語法檢查程式 (例如 Visual Studio 編輯器) 來尋找基本語法錯誤。查看適當的範本參照 (TileTemplateType)，確認影像數目正確，而且將正確的影像指派給正確的影像索引。
修正：變更您的 XML 或使用符合您內容的其他範本。同時，請考慮使用 NotificationsExtensions 程式庫來避免直接操作 XML。
確定您的通知還沒有過期
可能的原因：到期時間設定的值太小。
如果透過 expirationTime 方法 (針對本機通知) 或 X-WNS-TTL 標頭欄位 (針對推播通知) 來設定通知的到期時間，請注意值代表毫秒。例如，如果要讓磚通知持續顯示整整一小時，則值應該是 60 * 60 * 1000 = 3600000。
修正：使用較大的值。
如果要循環通知，請確定您已啟用通知佇列
可能的原因：磚通知佇列未啟用。
根據預設，磚一次只會顯示一個更新，而新的傳入通知會取代現有的通知。如果要循環顯示最後五個通知，則必須在應用程式的初始化程式碼中呼叫 TileUpdater.enableNotificationQueue(true)。此動作只需在應用程式的存留期間進行一次。如需詳細資訊，請參閱如何搭配本機通知使用通知佇列。
修正：在初始化程式碼中呼叫 enableNotificationQueue(true)。同時，確定通知標記是唯一的。
疑難排解排程通知
排程磚或快顯通知無法顯示
可能的原因：如果您遇到磚更新或快顯通知無法顯示的問題，通常都是因為通知的 XML 內容格式不正確。排程磚和快顯通知與非排程通知一樣，都必須符合磚與快顯通知 XML 結構描述。
修正：透過本機通知測試 XML，這是偵錯排程通知傳遞問題的第一步。如需詳細資訊，請參閱本主題的無法顯示本機磚通知或無法顯示本機快顯通知區段。
應用程式呼叫 AddToSchedule 方法失敗
可能的原因：您已超過排程通知允許的數目上限。
修正：如果您嘗試排程超過 4096 個通知，則 TileUpdater.addToSchedule 與 ToastNotifier.addToSchedule 都會失敗。減少排程通知的數目。
可能的原因：根據目前的系統時鐘時間，您的通知排定在過去的時間。
修正：確定通知排定在未來的時間。檢查系統時鐘時間。
疑難排解定期 (輪詢的) 通知
定期通知無法更新磚或徽章
如果您的定期通知無法顯示，可能是下列一或多個原因：
- Web 服務並未傳回符合磚 XML 結構描述的有效 XML 文件。如果在實作定期通知時遇到問題，請先確認磚的 XML 格式正確。偵錯定期通知的問題時，建議您先透過本機通知測試 XML。如需詳細資訊，請參閱本主題的無法顯示本機磚通知區段，以及快速入門：傳送磚更新。
- 輪詢要求傳回的文字格式不是 UTF-8。需要為 UTF-8 編碼。
- 您的服務未正確回應 Windows 在輪詢您服務提供的 URL 時所使用的 HTTP GET 要求。支援 HTTP 與 HTTPS 通訊協定。
- 您的應用程式未在應用程式資訊清單檔案 (package.appxmanifest) 中宣告網際網路功能。在 Visual Studio 資訊清單編輯器中，您會在 [功能] 索引標籤下找到此 [網際網路 (用戶端)] 選項。如果沒有宣告應用程式的這個功能，Windows 就不會輪詢您的服務。
- 確定 X-WNS-Tag 和 X-WNS-Expires 標頭設定的值格式正確。X-WNS-Expires 必須使用下列其中一種格式：
- Sun, 06 Nov 1994 08:49:37 GMT
- Sunday, 06-Nov-94 08:49:37 GMT
- Sun Nov 6 08:49:37 1994
定期更新延遲
- 如有需要，Windows 可將您的 URL 輪詢延遲最多 15 分鐘，以便最佳化電源與效能。
- 連絡您的 URL 時，您的服務無法使用。如果服務無法使用，必須等到下次輪詢間隔，才會再次予以連絡。
疑難排解推播通知
本節可解決您在使用推播通知時可能遇到的一些常見錯誤。
- 檢查您的事件記錄檔
- 推播通知收到「200 確定」回應但未顯示
- 推播通知傳回「200 確定」以外的代碼
- 嘗試建立推播通知通道時發生錯誤
檢查您的事件記錄檔
如果磚或快顯推播通知並未如預期般顯示，請查看事件記錄檔。
- 如果已收到通知但未顯示：啟動 [事件檢視器]，然後檢查 Applications and Services\Microsoft\Windows\PushNotifications-Platform 下方的 Microsoft-Windows-TWinUI/Operational 記錄檔。
- 如果完全沒有收到通知：啟動 [事件檢視器]，然後檢查 Applications and Services\Microsoft\Windows\PushNotifications-Platform 下方的作業記錄。
推播通知收到「200 確定」回應但未顯示
如果 Windows 推播通知服務 (WNS) 傳回「200 確定」回應，就會在用戶端上線時將通知傳遞給用戶端。如果您確定用戶端已上線但通知仍無法顯示，請逐一進行下列步驟：
原因：通知內容中的 XML 錯誤。
修正：確認基本 XML 語法，並確認您的 XML 是完整而且正確的。XML 內容的一些常見錯誤包括：
- 區分大小寫。標記名稱、屬性名稱以及屬性值都有大小寫之分。確定您的 XML 的大小寫是正確的。
- 必須為每種支援的磚格式分別提供 binding 元素。您應該針對所傳送的每個通知中支援的每個磚大小分別提供 binding 元素。
- 文字字串不可以包含保留的 XML 字元。例如，您不可以使用 <i> 和 </i> 標記，將磚或快顯通知的字串設定為斜體。如果您想要顯示文字字元 "<i>"，則應該適當地逸出。如需 XML 中逸出字元的詳細資訊，請參閱 XML 字串實體與 XAML。
- 針對 lang 屬性提供的值必須符合 ITEF BCP 47 規格。
- 透過推播通知傳送的 XML 字串必須使用 UTF-8 編碼。
- 如果在具有非空白 src 屬性的 XML 承載中包含 image 元素，也必須包含有效影像的參照，否則將捨棄通知。
如需詳細資訊，請參閱磚、快顯通知及徽章結構描述文件。
原因：不正確使用推播通知 API 參數
修正：請參閱 Windows.Networking.PushNotifications 命名空間中的 API 文件，以取得詳細資訊。
原因：標頭類型不符合通知內容。如果 X-WNS-Type 標頭並未設為對應至承載所指定之通知範本的值 — 磚、徽章或快顯通知 — 就無法顯示通知。這種不相符的狀況會在用戶端造成錯誤且捨棄通知。
修正：請參閱推播通知服務要求和回應標頭，確認應用程式伺服器使用正確的 X-WNS-Type 標頭值。
原因：X-WNS-TTL 標頭中設定存留時間 (TTL) 的值太小。
修正：提供較大的 TTL 值，請注意，此值是以秒為單位。
根據上述步驟解決問題後，如果仍然無法顯示通知，請參閱本主題的無法顯示本機磚通知區段中的本機通知疑難排解步驟，以取得進一步建議。
推播通知傳回「200 確定」以外的代碼
如果 WNS 沒有傳回「200 確定」，通知就不會傳遞給用戶端。如果傳回碼介於 400 至 499，則您身為開發人員，應該能夠修正問題。如需特定代碼意義的相關資訊，請參閱 Windows 推播通知服務 (WNS) 回應碼參照。如需說明如何攔截和處理這些錯誤的範例程式碼，請參閱快速入門：傳送推播通知或下載推播與定期通知範例。
注意 如需此處未特別列出的相關錯誤，請參閱 COM Error Codes (WPN, MBN, P2P, Bluetooth)。
- 通知要求傳回「400 錯誤要求」
- 通知要求傳回「401 未授權」
- 通知要求傳回「401 未授權」，權杖到期
- 通知要求傳回「403 禁止」
- 通知要求傳回「404 找不到」
- 通知要求傳回「406 無法接受」
- 通知要求傳回「410 不存在」
通知要求傳回「400 錯誤要求」
原因：使用的一或多個 WNS 標頭不正確或者 HTTP 要求無效。
修正：請參閱推播通知服務要求和回應標頭，確認應用程式伺服器使用上述所有自訂標頭。
通知要求傳回「401 未授權」
原因：應用程式伺服器必須使用正確的套件安全性識別碼 (套件 SID)，以及註冊應用程式時取得的祕密金鑰。如果您最近在 Windows 市集儀表板中變更了祕密金鑰，您也必須更新應用程式伺服器。如需詳細資訊，請參閱推播通知概觀。
修正：前往 Windows 市集儀表板，確認套件 SID 與密碼。
通知要求傳回「401 未授權」，權杖到期
原因：存取權杖的存留期有限。如果您使用過期的存取權杖傳送通知，應用程式伺服器的認證就會失效，無法傳送通知。
修正：提供您的套件安全性識別碼 (套件 SID) 與祕密金鑰供 WNS 進行驗證，以便向 WNS 要求新的存取權杖。如需詳細資訊，請參閱 Windows 推播通知服務 (WNS) 通知概觀。
通知要求傳回「403 禁止」
原因：如果您提供的存取權杖不符合將通知傳送給對應通道 URL 時所需的認證，就會發生此錯誤。每一個應用程式都必須向 Windows 市集註冊，才能收到應用程式伺服器的認證。對於每個應用程式來說，只有 Windows 市集提供的認證才能用來將通知傳送給該應用程式，而這些認證也只能用於該特定應用程式。
修正：使用開發人員帳戶登入 Windows 市集儀表板。選取您的應用程式，然後按一下 [進階功能] -> [管理您的雲端服務設定]。選取 [識別您的應用程式]，閱讀關於更新應用程式資訊清單以符合雲端服務認證的指示。
通知要求傳回「404 找不到」
原因：此錯誤通常表示通道 URL 的格式不正確。將通知傳送到 WNS 時，通道 URL 絕對不可以遭到竄改或修改。通道 URL 應一律視為不透明字串 — 不需要檢查，甚至也不需要知道內容。
修正：確認您的程式碼並未變更通道 URL 的一或多個字元或編碼。
通知要求傳回「406 無法接受」
原因：WNS 設有保護原則，可防止惡意應用程式對其他使用者與開發人員的服務造成不良影響。在極短時間內出現過量的通知，會導致 WNS 明確捨棄通知。
修正：檢查您的通知頻率，了解是否能降低或最佳化這個值，以提供使用者較佳的體驗。
通知要求傳回「410 不存在」
原因：通道 URL 已到期。除非應用程式執行並要求新的通道 URL，否則無法再傳送通知。
修正：Windows 市集應用程式啟動時應一律要求通道 URL。無法保證指派的通道 URL 會一直保持相同。如果 URL 變更，用戶端應該更新雲端伺服器上的資訊。如需詳細資訊，請參閱如何要求、建立以及儲存通知通道。
嘗試建立推播通知通道時發生錯誤
- 建立通知通道時發生 ERROR_NO_NETWORK 錯誤
- 建立通知通道時發生 WPN_E_CLOUD_INCAPABLE 錯誤
- 建立通知通道時發生 WPN_E_INVALID_APP 錯誤
注意 如需此處未特別列出的相關錯誤，請參閱 COM Error Codes (WPN, MBN, P2P, Bluetooth)。
建立通知通道時發生 ERROR_NO_NETWORK 錯誤
原因：WNS 需要有網際網路連線才能建立通知通道。
修正：檢查網際網路連線。
建立通知通道時發生 WPN_E_CLOUD_INCAPABLE 錯誤
原因：您的應用程式尚未在應用程式資訊清單 (package.appxmanifest) 中宣告網際網路功能。
修正：確認應用程式資訊清單已宣告網際網路功能。在 Visual Studio 資訊清單編輯器中，您會在 [功能] 索引標籤下找到此 [網際網路 (用戶端)] 選項。如需詳細資訊，請參閱 Capabilities。
建立通知通道時發生 WPN_E_INVALID_APP 錯誤
原因：應用程式必須使用有效的套件名稱。如果您尚未收到有效的套件名稱，可以在 Windows 市集入口網站的 [進階功能] 下取得。
修正：如需擷取 Windows 市集應用程式套件安全性識別碼 (PKSID) 的詳細資料，請參閱如何使用 Windows 推播通知服務 (WNS) 進行驗證。
疑難排解快顯通知
本節可解決您在使用快顯通知與快顯通知範本時可能遇到的一些常見錯誤。快顯通知的疑難排解步驟與磚通知的疑難排解步驟大致相同。除非另有指定，否則每個解決方案都適用於所有通知傳遞類型：本機、排程或推播通知。
無法顯示本機快顯通知
此情況中最常見的問題是用來定義通知的 XML 有某些地方不正確。不過，還是有其他可能的原因，這些步驟會逐步引導您：
- 檢查使用者設定
- 檢查應用程式資訊清單項目
- 檢查影像大小
- 驗證您的 URL
- 檢查您的影像格式
- 檢查您的 XML 的語法
- 檢查通知的到期時間
檢查使用者設定
可能的原因：使用者或系統管理員透過設定停用了通知。在 [電腦設定] -> [通知] 頁面中，檢查全域通知開關，以及每一應用程式的開關。至於系統管理員，有數個群組原則可以停用通知。洽詢您的系統管理員，確定已啟用通知。
修正：透過設定啟用通知，或請系統管理員透過群組原則啟用通知。
如需詳細資訊，請參閱快速入門：傳送快顯通知。
檢查應用程式資訊清單項目
可能的原因：應用程式資訊清單未設定適當資訊，無法傳送快顯通知。確認應用程式資訊清單中的 [Toast 可達到] 設定已設為 [是]。如果有從網際網路擷取的任何通知內容 (例如影像)，請確認已在應用程式資訊清單中宣告 [網際網路 (用戶端)] 功能。
修正：在應用程式資訊清單中，啟用通知專屬項目。
如需詳細資訊，請參閱快速入門：使用 Visual Studio 資訊清單編輯器建立預設磚。
檢查影像大小
可能的原因：所有通知的影像必須小於 1024 x 1024 個像素，而且小於 200 KB。如果通知中的影像超過任何這些尺寸，將會捨棄通知。
修正：縮小影像。
如需詳細資訊，請參閱磚與快顯通知影像大小。
驗證您的 URL
可能的原因：URL 語法錯誤。
通知中的影像會以資源參照或文字路徑指定。如果使用路徑，必須使用三種通訊協定的其中一個來指定：
| 首碼 | 用途 | 附註 |
|---|---|---|
| http:// 和 https:// | 線上儲存的影像 | 這些影像可以由本機快取，因此影像伺服器可能不會收到影像要求。查詢字串會附加至這些 URL 中。如果選擇忽略查詢字串，請確定網頁伺服器傳回原始影像而不是 404。查詢字串範例：?scale=100&contrast=blk&lang=en-US 請注意，若要從網際網路抓取任何通知內容，您的應用程式必須在其應用程式資訊清單中宣告「網際網路 (用戶端)」功能。 |
| ms-appx:/// | 包含於應用程式套件中的影像 | URI 接受斜線 (/) 或反斜線 (\) 來分隔路徑中的資料夾，但是大部分的程式設計語言要求您在指定反斜線 (\\) 時使用逸出字元。請注意，此參照在冒號後需要三斜線。 |
| ms-appdata:///local/ | 應用程式將影像儲存在本機 | 此位置會對應 Windows.Storage.ApplicationData.current.localFolder 傳回的資料夾。路徑中資料夾的分隔符號必須使用逸出字元 (\\)。請注意，此參照在冒號後需要三斜線。 |
注意 '/' 字元在每個規則類型中都做為分隔符號。建議您都使用 '/' 而不是 '\'，以避免使用逸出字元時產生的混淆。
正確格式範例：
| URL |
|---|
| https://www.contoso.com/icon.jpg |
| ms-appx:///images/icon.png |
| ms-appdata:///local/myDrawing.jpg |
錯誤格式範例：
| URL | 附註 |
|---|---|
| https://www.contoso.com\fail.png | HTTP 路徑必須使用 / 字元。請勿使用 \ 字元。 |
| http:www.contoso.com | HTTP 路徑在冒號後需要雙斜線 (//)。 |
| "ms-appdata:///local/c:\\images\\Drawing.jpg" | 應用程式無法參照其本機存放區外的影像。 |
| "ms-appx://images/triangle.png" | "ms-appx:" 中請使用三斜線而不是雙斜線。 |
檢查您的影像格式
可能的原因：不支援的影像格式。
通知僅能使用 .png、.jpg/.jpeg 或 .gif 格式的影像。影像的格式必須也要與其副檔名相符。只是將不支援的檔案類型重新命名為支援的副檔名沒有用。
影像格式錯誤最常見的原因是將點陣圖序列化至 Windows.Storage.ApplicationData.current.localFolder 存放區。務必使用您慣用的格式，否則影像會儲存為 Windows 點陣圖，且其標頭將會包含 "BMP"。
驗證：驗證影像格式的其中一種方式，是將影像載入至影像處理程式並儲存為 .jpg。如果您在通知中參照這個新的 .jpg 檔案且錯誤沒有重覆出現，就表示可能有影像格式錯誤。您也可以在 Visual Studio 二進位編輯器中開啟這個檔案來檢查其標頭。
修正：變更或修正影像格式。
檢查您的 XML 語法和內容
可能的原因：XML 語法或驗證錯誤。
除了基本語法外，請確認您的 XML 是完整而且正確的。XML 內容的一些常見錯誤包括：
- 區分大小寫。標記名稱、屬性名稱以及屬性值都有大小寫之分。確定您的 XML 的大小寫是正確的。
- 文字字串不可以包含保留的 XML 字元。例如，您不可以使用 <i> 和 </i> 標記，將快顯通知中的字串設定為斜體。如果您想要顯示文字字元 "<i>"，則應該適當地逸出。如需 XML 中逸出字元的詳細資訊，請參閱 XML 字串實體與 XAML。
- 針對 lang 屬性提供的值必須符合 ITEF BCP 47 規格。
- 在本機建立的 XML 字串 (針對本機或排程通知) 必須使用 UTF-16 編碼。如果字串透過推播通知傳送或從 URL 輪詢，則應該使用 UTF-8 編碼。
- 如果在具有非空白 src 屬性的 XML 承載中包含 image 元素，也必須包含有效影像的參照，否則通知會失敗。
如果快顯通知無法顯示，可以使用事件記錄檔來檢查是否有錯誤。若要在事件檢視器查詢快顯通知的相關事件，請前往 [應用程式及服務記錄檔] > [Microsoft] > [Windows] > [Apps] > [Microsoft-Windows-TWinUI] > [Operational]。
驗證：使用 XML 語法檢查程式 (例如 Visual Studio 編輯器) 來尋找基本語法錯誤。查看適當的範本參照 (ToastTemplateType)，確認將正確的項目指派給正確的元素。
修正：變更您的 XML 或使用符合您內容的其他範本。
確定您的通知還沒有過期
可能的原因：到期時間設定的值太小。
如果透過 expirationTime 方法 (針對本機通知) 或 X-WNS-TTL 標頭欄位 (針對推播通知) 來設定通知的到期時間，請注意值代表毫秒。例如，如果要讓快顯通知持續顯示整整一小時，則值應該是 60 * 60 * 1000 = 3600000。
修正：使用較大的值。
回報問題
如果您已經嘗試過本主題所建議的解決方案，但無法解決您的問題，可以在 Microsoft 論壇張貼訊息，與 Microsoft 開發人員和對此問題有興趣的其他人共同討論。
如果是推播通知，除了說明問題之外，可能還會要求您提供通道 URL 以及從 WNS 收到的回應範例，包括 HTTP 錯誤碼及 HTTP 標頭。回報問題時，應用程式伺服器應該要記錄某些特定標頭。如需詳細資訊，請參閱推播通知服務要求和回應標頭。