意義
資源已永久消失,且沒有已知的新位址。與 404 不同,這是伺服器刻意聲明的。
常見原因
- 內容被刻意刪除
- 某個 API 版本已停用
- 過期的促銷或刊登資訊
解決方法
用戶端或訪客
移除該連結或書籤;資源不會再回來。對 API 而言,請遷移到替代版本。
網站或 API 的維護者
刻意移除的內容使用 410,搜尋引擎會更快移除該 URL;如果有真正的替代頁面,使用 301。
回應範例
HTTP/1.1
HTTP/1.1 410 Gone
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Gone",
"status": 410,
"detail": "API v1 was retired on 2025-01-31. Use /v2."
} 規範
常見問題
› 對 SEO 而言 410 比 404 好嗎?
搜尋引擎移除 410 URL 可能稍快,但兩者最終都會從索引中移除。
› 回傳過 410 的頁面還能恢復嗎?
技術上可以,但用戶端可能已經遺忘它。不確定時用 404。