有效的錯誤報告需要造成失敗的結構,不是真實客戶資料。不要先把正式資料貼到公開問題區,再遮住幾個明顯姓名。巢狀欄位、ID、URL 和自由文字仍可能識別個人。
重新建立可重現語法問題的虛構範例。尾端逗號問題用 {"demo":[1,2,]} 就足夠,包含屬性、陣列與錯誤逗號,無須揭露原始記錄。若問題不同,保留最小必要的巢狀或跳脫結構,並虛構全部數值。這是手動建立範例;兩個工具都不是自動匿名化工具。
最終報告可以很簡短:
- 工具 URL 與模式。
- 會失敗的虛構輸入。
- 準確複製的實際錯誤。
- 建議的虛構輸出與小幅差異。
- 修正輸出是否能由格式化工具解析。
- 尚未測試的項目,例如使用端應用程式的結構規則。
若無法在不用真實資料的情況下重現,請先不要公開。請詢問獲准的私密回報途徑,不要以為本機處理能讓後續截圖或問題貼文也保密。測試後清除範例,並檢查截圖有無無關分頁或帳號資料。
一眼比較範例
| 階段 | 輸入或看到的內容 |
|---|---|
| 失敗的輸入 | {"demo":[1,2,]}] 前的最後一個逗號無效。 |
| 執行結果 | 選擇模式:格式化 → 執行。測試版本顯示「請檢查輸入與所選格式。」。輸出保持空白,複製結果不可用。錯誤文字可能不同。 |
| 修正輸入 | {"demo":[1,2]}再次執行。輸出應包含 demo 與陣列 [1, 2];縮排可改變,但數值不能改變。 |
在實際格式化工具重現範例
- 開啟 JSON 格式化與驗證。在 輸入 中貼上
{"demo":[1,2,]}。選擇 格式化 ,所在設定為 模式,接著 執行。 - 預期出現錯誤,而非格式化成功的輸出。文字可能隨瀏覽器或版本不同,請照實複製。本例不允許緊接在此符號前的逗號:
];JSON 不允許這個位置出現逗號。 - 將輸入換成
{"demo":[1,2]},再次執行。輸出應包含屬性demo及兩個數字1與2,放在陣列中。空格與縮排是格式,不是新增資料。 - 回報成功前,重新解析結果或比較數值。在 文字比較 中,需要展示移除逗號的差異時,比較兩個虛構字串。比較本身不能驗證 JSON。
- 報告中加入兩個字串、所選模式、實際錯誤和修正結果,並註明尚未測試結構規則及使用端程式。選擇 重設 ,在結束後清空工具。
結果不同時
- 仍然無效: 檢查雙引號、結尾括號及意外複製的文字。每次修正一個虛構錯誤,不要任意刪除正式欄位。
- JSON 有效但應用程式拒絕: 語法成功不代表必要欄位、型別或業務規則都正確。在獲准的私密環境檢查該程式正式說明的結構規則。
- 重複鍵警告: 不要靠重新排版掩蓋。不同使用端可能以不同方式解讀重複屬性,請明確表達原本要的結構。
常見問題
這能匿名化正式記錄嗎?
不能。請從零虛構範例。格式化或替換明顯姓名,都無法保證移除識別資料。
結果有效,為什麼應用程式仍有問題?
格式化工具只檢查及整理支援的 JSON 語法,不會執行應用程式的結構規則,也不會將值當成程式碼執行。