錯誤報告 使您能夠查看伺服器和客戶端的最新 Luau 系統錯誤和警告。在更新遊戲前後監控您的錯誤報告，以便及早識別潛在問題。
查看您的錯誤報告
要查看您的遊戲的錯誤報告：
- 在 創作者儀表板 中導航到您的 創作 頁面並選擇您的遊戲。
- 在 監控 下，選擇 錯誤報告。
您可以查看單獨或群組擁有的體驗的分析。要查看後者，您需要擁有 群組分析權限。
監控錯誤和警告
您可以將以下過濾器和切換應用於您的錯誤報告：
- 日期範圍 — 過濾最近 1 小時、最近 1 天、最近 7 天或最近 30 天。
- 地點 — 按地點過濾。
- 顯示版本 — 在錯誤和警告圖表中添加地點版本註解。
- 嚴重性 — 過濾以顯示錯誤、警告或兩者。
- 平台 — 過濾以顯示來自特定設備的客戶端錯誤。
- 操作系統 — 過濾以顯示來自特定操作系統的客戶端錯誤。
- 自某版本以來的新錯誤 — 過濾以僅顯示從某個版本以來的新錯誤和警告。
在過濾器和切換下方，會顯示伺服器、客戶端和總的錯誤和警告數量的圖表。使用此圖表查看錯誤和警告隨時間的增加情況。如果您看到錯誤和警告的大幅激增，請使用錯誤報告表進行故障排除。
故障排除錯誤和警告
錯誤和警告 表有以下列：
| 列 | 描述 |
|---|---|
| 數量 | 錯誤或警告的數量。 |
| 嚴重性 | 錯誤或警告標籤。 |
| 類型 | 伺服器或客戶端標籤。 |
| 消息 | 錯誤或警告消息。 |
| 首次出現時間 | 消息的首次出現時間戳。 |
| 首次出現版本 | 只有在選擇了地點時才可用。顯示記錄該消息的首個版本。 |
查看錯誤或警告的堆棧跟蹤
如果在錯誤或警告上看到下拉選單，點擊以展開並查看其相應的 堆棧跟蹤。堆棧跟蹤是您的遊戲在拋出異常時所執行的調用列表。這可以幫助您找出出錯的原因。
自定義規則
自定義規則讓您定義正則表達式或確切字符串模式，以自動忽略或分組錯誤和警告。這有助於您管理錯誤報告的信噪比。您可以為每個體驗創建最多 100 條規則。規則按優先順序從上到下進行評估。一旦錯誤匹配到一條規則，進一步處理將停止。
規則操作
每條規則有兩種操作之一：
| 操作 | 行為 |
|---|---|
| 忽略 | 隱藏圖表和表中的匹配錯誤。用於如不可避免的引擎音效錯誤或舊版打印語句等永久噪聲。 |
| 分組 | 將所有匹配錯誤合併到一個自定義組名下（例如，“網絡問題”，“音頻垃圾”）。組名以單行顯示在表中。 |
創建規則
有兩種創建規則的方法：
從錯誤表（內聯）：
- 點擊任意錯誤行上的上下文菜單（三個點）。
- 選擇 忽略。
從規則標籤：
- 在錯誤報告頁面導航到 規則 標籤。
- 點擊 創建規則。
- 輸入模式（確切字符串或正則表達式）。
- 選擇一個操作：忽略 或 分組 → [組名]。
- 保存規則。
規則創建字段
| 字段 | 描述 |
|---|---|
| 模式 | 精確字符串或正則表達式，用於與錯誤消息相匹配。 |
| 操作 | 選擇 忽略（隱藏錯誤）或 分組 → 輸入自定義組名。 |
規則根據規則標籤中的優先順序從上到下進行評估。一旦錯誤匹配到一條規則，該規則的操作將被執行，並且不會再為該錯誤評估進一步的規則。這防止了類似錯誤被一條規則分組後又被隨後的規則忽略的衝突。
規則僅影響在保存後記錄的錯誤。當修改規則時，您的圖表上將出現註解。
正則表達式基礎
正則表達式（regex）是匹配文本的模式：
| 語法 | 含義 | 例子 |
|---|---|---|
| . | 任何單個字符 | H.t 匹配 "Hat"、"Hit"、"Hot" |
| * | 前一個字符的零個或多個 | go*d 匹配 "gd"、"god"、"good" |
| + | 前一個字符的一個或多個 | go+d 匹配 "god"、"good"，但不匹配 "gd" |
| .* | 任何字符序列（萬用字元） | Failed.*load 匹配 "Failed to load" 和 "Failed xyz load" |
| \d | 任何數字（0-9） | v\d+ 匹配 "v1"、"v123"、"v4488" |
| \w | 任何單詞字符（字母、數字、下劃線） | \w+ 匹配 "Player123"、"my_var" |
| ^ | 字串的開始 | ^HTTP 匹配以 "HTTP" 開頭的錯誤 |
| \/ | 轉義的正斜杠 | rbxassetid:\/\/ 匹配 "rbxassetid://" |
| \[ 和 \] | 轉義的方括號（文字匹配） | \[Knit\] 匹配 "[Knit]" |
| (a|b) | 匹配 "a" 或 "b" | (Error|Warning):.* 同時匹配 "Error: ..." 和 "Warning: ..." |
快速提示：
- 如果您只想捕獲一個特定錯誤，請從精確匹配（完整錯誤字符串）開始。
- 當您想要捕獲一組相似錯誤時，使用正則表達式（例如，所有音頻加載失敗，不管資產 ID 為何）。
- 在保存之前，對幾個真實的錯誤字符串測試您的模式，確保它能捕獲您所預期的內容。
系統對您的正則表達式模式施加兩條規則：
- 您不能在重複組裡放置重複符號（+ 或 *）。例如，(a+)* 或 (\w+)+ 會被拒絕。
- 必須以錨定文本開始：模式不能以萬用字元如 .* 或 .+ 開頭。您的模式必須以具體字符或錨定符（如 ^ 或一個字面字符串）開始。
規則示例以組織您的錯誤報告
不再看到數十個單獨的錯誤行，而是將相關錯誤合併為一個組名稱：
| 用例 | 示例錯誤 | 模式 | 操作 |
|---|---|---|---|
| 所有網絡錯誤 | HttpError: ConnectFail、HttpError: Timedout | HttpError:.* | 分組 → "網絡問題" |
| 數據存儲警告 | DataStore request was added to queue、DataStoreService: ... | DataStore | 分組 → "數據存儲警告" |
| 玩家 GUI 錯誤 | Players.Player1.PlayerGui.Shop:12: attempt to index nil | Players\.\w+\.PlayerGui | 分組 → "PlayerGui 錯誤" |
| 自定義 UI 框架 | [UIManager] Button render failed、[UIManager] Layout overflow | \[UIManager\].* | 分組 → "UI 系統" |
錯誤跟踪限制
系統根據計數跟踪多達 500 個唯一錯誤和 500 個唯一警告，以及每個版本的前 100 個新錯誤。這些計數每 6 小時重置。要最大限度地提高這些限制內有用的錯誤跟踪：
- 從錯誤消息中刪除唯一識別符，例如用戶 ID、坐標或時間戳。錯誤如 Player 12345 failed to load 和 Player 67890 failed to load 計作兩個單獨條目。如果將其記錄為 Player failed to load，則它們會合併為一個條目，計數更高。
- 使用自定義規則來分組僅由動態值不同的相關錯誤。
解決錯誤和警告
在從錯誤報告頁面調查錯誤時，使用以下方法：
- 查看堆棧跟蹤 — 展開錯誤行以查看調用路徑，並確定錯誤發生的確切腳本和行號。
- 檢查最近更新 — 監控自您最近更新以來的新錯誤。
- 使用細分 — 檢查錯誤是否特定於某個平台（桌面、移動、控制台）或操作系統（Windows、macOS、iOS、Android）。
- 收集社區反饋 — 如果您有社區 Discord 或 DevForum 帖子，請檢查玩家是否報告了問題以及哪些設備或地區受到了影響。