Temu duga umum: Bilakah HTTP 410 Gone patut menyatakan kitaran hayat sumber?

Prom dan skop

Versi API awam dan sumber web dialih keluar secara kekal. Pasukan mahu klien berhenti mencuba semula sambil mengekalkan laluan migrasi dan bukti audit. Bandingkan 410, 404, 301/308, dan 403, kemudian reka bentuk respons, caching, tempoh penutupan, dan pemantauan.

Ini ialah soalan semantik HTTP dan kitaran hayat produk. Versi dan tarikh persaraan adalah andaian, bukan tuntutan pasaran.

Perkara yang diuji oleh penemu duga

• Sama ada anda membezakan antara "tidak tersedia buat masa ini" dengan "diketahui dialih keluar secara kekal".
• Sama ada anda memahami kesan 410 terhadap caching dan klien.
• Sama ada migrasi, pengesahan, privasi, dan audit mempunyai satu model kitaran hayat.
• Sama ada anda mengelak daripada menggunakan kod status untuk menyembunyikan gangguan yang tidak diketahui atau pepijat penghalaan.

Soalan penjelasan untuk ditanya

1. Adakah sumber dipadamkan secara kekal, luar talian buat sementara waktu, atau dipindahkan ke URI yang stabil?
2. Adakah cache, indeks carian, percubaan semula SDK, atau klien luar talian terlibat?
3. Adakah peraturan pengekalan, pematuhan, atau audit mengekang pemadaman?
4. Bolehkah klien lama memahami 410 dan maklumat migrasi dalam badan ralat?
5. Patutkah pengguna yang tidak dibenarkan melihat 404 untuk menyembunyikan kewujudan sumber?

Jawapan 30 saat

"410 bermaksud pelayan mengetahui sasaran itu pernah wujud tetapi telah mengalih keluarnya secara kekal; 404 hanya menyatakan tiada representasi semasa tersedia. Gunakan 301 atau 308 apabila pengganti yang stabil wujud, dan 403 atau 404 berasaskan keselamatan untuk kebenaran. Umumkan persaraan melalui dokumentasi, SDK, dan tempoh migrasi, kemudian kembalikan 410 dengan kod stabil dan pautan dokumentasi menggunakan kawalan cache yang teliti. Klien harus berhenti mencuba semula tanpa faedah. Pemadaman kekal boleh diaudit, dan saya mengukur trafik persaraan, tingkah laku cache, serta kejayaan migrasi."

Reka bentuk langkah demi langkah

1. Bina jadual keputusan keadaan

Gunakan 410 untuk sumber yang dialih keluar secara kekal yang tidak akan disediakan lagi. Gunakan 404 apabila kewujudan atau ketersediaan masa hadapan tidak diketahui, dan lencongan apabila sumber mempunyai URI baharu yang jelas. Sama ada kegagalan kebenaran adalah 403 atau 404 yang disamarkan bergantung pada model ancaman dan dasar pendedahan.

2. Reka bentuk respons 410

Sertakan kod ralat yang stabil, ID permintaan, dokumentasi persaraan, dan petunjuk penggantian pilihan. Jangan dedahkan sebab pemadaman yang sensitif atau keadaan pangkalan data. API boleh menggunakan badan ralat berstruktur; halaman web boleh menyediakan penjelasan migrasi yang mudah diakses. Kedua-duanya mesti mengekalkan semantik 410 yang boleh dibaca mesin.

HTTP/1.1 410 Gone
Cache-Control: max-age=3600
Content-Type: application/problem+json
Link: <https://api.example/migrations/v1>; rel="deprecation"

3. Kendalikan caching dan klien

410 secara umumnya boleh dicache secara heuristik melainkan definisi kaedah atau kawalan cache eksplisit menyatakan sebaliknya. Nilaikan risiko pembatalan palsu, tingkah laku CDN, dan cache klien tempatan sebelum memilih jangka hayat. Jika keputusan boleh berubah, mulakan dengan tempoh pendek dan lanjutkan secara beransur-ansur. Klien yang melihat 410 harus menghentikan percubaan semula yang sia-sia dan memasuki logik migrasi atau notis pengguna.

4. Rancang tempoh persaraan

Terbitkan tarikh penamatan dalam dokumentasi, SDK, dan pengepala respons, kemudian segmenkan penggunaan mengikut pemanggil, versi, dan trafik. Sepanjang tempoh tersebut, sediakan perkhidmatan dengan jayanya bersama isyarat migrasi; selepas itu kembalikan 410. Operasi tulis berisiko tinggi boleh ditolak terlebih dahulu sementara titik akhir migrasi baca sahaja kekal. Tentukan titik semakan pengembalian (rollback checkpoints) sebelum setiap perubahan.

5. Kekalkan bukti pemadaman dan privasi

410 tidak membuktikan pemadaman fizikal daripada storan. Rekod identiti sumber, kelulusan, masa pemadaman, dasar pengekalan, titik masuk penggantian, dan versi respons. Jangan sekali-kali mengekalkan kandungan sensitif yang dipadamkan dalam log. Jika pematuhan memerlukan pemadaman tertangguh, paparkan 410 sementara pengekalan dalaman dan pembersihan diteruskan di bawah kawalan mereka sendiri.

6. Pantau hasil yang diklasifikasikan

Asingkan 410 mengikut sumber, klien, versi SDK, capaian cache (cache hit), dan klik migrasi untuk membezakan persaraan sebenar daripada pepijat penghalaan. Bandingkan 404, 403, rantaian lencongan, jumlah percubaan semula, dan tiket sokongan. Jika 410 melonjak secara tidak dijangka, hentikan pelanjutan jangka hayat cache dan kembalikan konfigurasi sambil menyiasat.

Contoh jawapan berkualiti tinggi

"Saya mula-mula menentukan keadaan sumber. Pengalihan keluar kekal yang diketahui mendapat 410; ketiadaan yang tidak diketahui atau sementara mendapat 404; pengganti yang jelas mendapat 301 atau 308; kebenaran menggunakan 403 atau 404 berasaskan keselamatan. Saya mengumumkan tempoh migrasi melalui dokumen, SDK, dan pengepala, kemudian mengembalikan 410 dengan kod stabil, ID permintaan, dan pautan dokumentasi menggunakan caching yang berhati-hati. Klien berhenti mencuba semula. Pemadaman dan pengekalan diaudit secara berasingan, manakala metrik merangkumi sumber 410, cache, kejayaan migrasi, dan pencetus pengembalian."

Kesilapan biasa

• Mengembalikan 410 untuk setiap pemadaman → keadaan sementara atau tidak diketahui kelihatan kekal → kelaskan keadaan sumber.
• Mengembalikan 410 walaupun ada pengganti → klien kehilangan peluang migrasi → gunakan 301/308 dan dokumentasi.
• Mengecache 410 selama-lamanya → persaraan palsu sukar dibatalkan → tetapkan dan lanjutkan TTL mengikut risiko.
• Menganggap 410 sebagai bukti pemadaman fizikal → pengekalan dan pematuhan terlepas pandang → audit pembersihan secara berasingan.
• Hanya melihat jumlah keseluruhan → kegagalan SDK lama kekal tersembunyi → segmenkan mengikut versi, sumber, dan cache.

Soalan susulan dan respons

Apakah perbezaan penting antara 410 dan 404?

410 menyatakan bahawa pelayan mengesahkan bahawa sumber itu pernah wujud dan telah dialih keluar secara kekal. 404 tidak menyatakan sama ada ia pernah wujud atau sama ada ia mungkin muncul kemudian. Memilih 410 memberikan janji yang lebih kuat tentang tingkah laku percubaan semula, caching, dan migrasi.

Bolehkah 410 menyertakan pautan pengganti?

Ya, ia boleh menyediakan dokumentasi atau titik masuk migrasi, tetapi ia tidak boleh berpura-pura bahawa pengganti itu ialah sumber semasa. Klien masih perlu menyemak semula kebenaran, versi, dan pemetaan data.

Mengapakah pengguna yang tidak dibenarkan mungkin menerima 404?

Jika mendedahkan bahawa sesuatu sumber wujud membocorkan maklumat sensitif, pelayan boleh menyembunyikan kewujudan dengan 404 di bawah model ancamannya. Pemanggil yang dibenarkan masih perlu menerima semantik kitaran hayat yang konsisten dan boleh diaudit.