結構化資料報錯時先查哪裡：從來源、範圍到欄位的七步排查順序教學
結構化資料報錯時，先不要改程式碼。正確的排查順序是：分清錯誤與警告，找出產生這段標記的來源，確認受影響的頁面範圍，再逐一修正欄位，最後驗證並等待重新檢索。順序反過來，常常改了一頁，其他上百頁照樣報錯
這是一篇步驟教學。我把自己處理結構化資料報錯的流程拆成七步，每一步都寫出要看哪裡、要做什麼決定、什麼情況可以跳過。如果你還不熟悉結構化資料是什麼，建議先讀 結構化資料從 Organization 到 FAQPage 的實作順序，再回來照這篇排查
排查前要準備什麼？
開始之前，先把三樣東西準備好。少了任何一樣，後面的步驟都會卡住
- Search Console 的擁有者或完整權限，才能看到增強功能報表並按下驗證修正
- 網站後台的管理權限，包含主題、外掛或程式碼的存取
- 一份能記錄的試算表，欄位寫：錯誤類型、範例網址、標記來源、影響頁數、處理狀態、驗證日期
那份試算表很重要。結構化資料錯誤常常一次跳出好幾種，沒有記錄，你會在第三天忘記哪些改過、哪些還在等 Google 重新檢索
步驟一：分清錯誤、警告與無效項目
打開 Search Console 左側的增強功能報表，每一種結構化資料類型會各自一頁，例如麵包屑、常見問題、產品。進去後先看狀態分類，不要急著點開範例網址
依 Google 結構化資料簡介的說明，Google 會用結構化資料判斷頁面是否符合複合式搜尋結果的資格。錯誤代表項目有問題，可能因此失去資格；警告多半是缺少建議欄位，項目通常仍然有效。所以排序很簡單：錯誤先，警告後
這一步要做的決定只有一個：把每一種錯誤寫進試算表，並記下報表顯示的受影響項目數。數字大的不一定最急，但它告訴你這個問題是不是全站性的
步驟二：找出這段標記是誰產生的
這是最多人跳過、也最花冤枉時間的一步。同一段結構化資料，可能來自佈景主題、SEO 外掛、電商外掛、頁面編輯器，甚至是很久以前有人手動貼在頁尾的一段程式碼
做法是打開範例網址的原始碼，搜尋 application/ld+json，看有幾段，每段裡面的 @type 是什麼。再對照外掛設定，判斷每一段是哪個工具輸出的。有些外掛會在輸出的程式碼附近留下註解或特定類別名稱，可以當作線索
| 常見來源 | 特徵 | 排查時要看的地方 |
|---|---|---|
| 佈景主題 | 全站都有，版型相同的頁面一模一樣 | 主題設定或子主題的頁首頁尾檔案 |
| SEO 外掛 | 通常包含 Organization、WebSite、BreadcrumbList | 外掛的結構化資料或網站表示設定 |
| 電商外掛 | 只出現在商品頁，含 Product 與 Offer | 商品欄位是否填齊，例如價格與庫存 |
| 頁面編輯器區塊 | 只出現在特定頁，常見 FAQPage | 該頁編輯器裡的常見問題區塊 |
| 手動貼上的程式碼 | 格式不一，常有過期資訊 | 主題的自訂程式碼欄位或追蹤碼管理工具 |
找到來源後，在試算表寫下來。之後修正時，你改的是來源設定，而不是單一頁面
步驟三：判斷錯誤影響的範圍
來源確定後，就能推算範圍。若錯誤來自主題或外掛的全站設定，所有同類型頁面都會壞，修一次就全部好。若錯誤只出現在部分頁面，通常是內容層的問題，例如某些商品沒填價格、某些文章沒有作者
判斷方法是從報表裡多點開幾個範例網址，比較它們的共同點。都是同一個分類？都是某個日期之後新增的？都是同一個編輯建立的？共同點就是線索。我習慣至少看五個範例，只看一個很容易誤判成個案
步驟四：先處理重複與衝突，再處理缺漏
很多網站的錯誤不是少了欄位，而是同一種類型被輸出兩次，而且內容互相矛盾。例如主題輸出一個 Organization，名稱是舊公司名；SEO 外掛又輸出一個，名稱是新公司名。兩段都合法，但放在一起，搜尋引擎不知道該信哪一個
所以第四步的原則是：每一種類型只留一個負責的來源。把其他來源的對應功能關掉。這一步做完，有時候原本的錯誤就消失了，因為壞掉的那一段剛好是被關掉的那一段
提醒一件事：關閉外掛功能前，先備份網站或保存主題版本。結構化資料的設定常和其他功能綁在一起，例如麵包屑導覽的顯示，關錯了版面會跟著變
步驟五：逐欄修正必要屬性
到這一步，才真正開始改欄位。每一種結構化資料類型都有自己的必要屬性與建議屬性，要以 Google 該類型的說明文件為準，不要只看通用的 Schema.org 定義，因為 Google 支援的範圍比 Schema.org 窄
修正時常見的四種情況
- 欄位空白：內容本身沒填，例如商品沒有價格，回後台補資料
- 格式錯誤：日期沒有依標準格式、網址是相對路徑，改外掛或主題的輸出設定
- 值不合理：評分超出範圍、價格帶有貨幣符號文字，檢查資料欄位是否混入多餘字元
- 標記內容與頁面不一致：標記寫的資訊在頁面上看不到，應讓兩者對齊，不要只改標記
最後一種情況要特別小心。結構化資料應該描述頁面上看得到的內容。為了取得複合式結果而標記頁面上沒有的資訊，可能讓整個項目失去資格。關於驗證通過卻沒有出現複合式結果的情況，可以參考 結構化資料驗證通過卻沒有複合式搜尋結果的九段問答
步驟六：先測一頁，再驗證全部
改完一個來源，不要馬上去報表按驗證。先挑一個範例網址，用 Search Console 的網址檢查工具測試即時版本，確認新版本已經沒有錯誤。如果網站有快取外掛或 CDN，先清除快取，否則工具抓到的可能還是舊頁面
單頁通過後，再多測兩三個不同分類的頁面。確定都沒問題，才回到增強功能報表按下驗證修正。Google 會開始重新檢查受影響的網址，這需要時間，報表上的狀態不會立刻更新
步驟七：記錄、等待與複查
驗證送出後，在試算表寫下日期。接下來要做的是等待，以及在固定時間回來看。我通常隔一週看一次狀態變化。若驗證失敗，報表會列出仍有問題的網址，拿這些網址回到步驟三，看它們有沒有新的共同點
商品類的結構化資料錯誤特別容易反覆出現，因為價格與庫存天天在變。若你的問題集中在商品頁，可以延伸閱讀 商品結構化資料標記錯誤的修正順序
排查順序總覽
| 步驟 | 要回答的問題 | 可以跳過的情況 |
|---|---|---|
| 一、分類 | 這是錯誤還是警告 | 報表只有警告時，可排到後面處理 |
| 二、來源 | 這段標記是誰產生的 | 網站只有一個來源輸出結構化資料 |
| 三、範圍 | 影響全站還是部分頁面 | 受影響項目只有一兩頁 |
| 四、去重 | 同類型有沒有被輸出兩次 | 原始碼裡每種類型只有一段 |
| 五、欄位 | 缺了哪些必要屬性 | 前四步做完錯誤已消失 |
| 六、測試 | 即時版本是否已經沒有錯誤 | 不建議跳過 |
| 七、複查 | 驗證是否完成 | 不建議跳過 |
適用與不適用的情況
這套順序適用於使用內容管理系統、同時裝了多個外掛的中小企業網站，特別是曾經換過主題或 SEO 外掛的網站。這類網站最常見的問題是來源重複，照順序排查能省下最多時間
它比較不適用於完全手寫程式碼、只有少數幾頁的網站。那種情況下，標記來源很單純，直接從步驟五開始改即可。另外，本文不處理結構化資料是否會讓網站出現在 AI 搜尋摘要中的問題，相關說明請看 Google 的 AI 功能與網站說明。Google 也明確表示，正確的結構化資料不保證一定會顯示複合式結果
如果你的網站錯誤類型很多、來源又分散，需要有人陪你整理成一份可執行的清單，可以參考 冠誠數位行銷的服務項目中的網站技術健檢