07/troubleshooting

Sorun Giderme ve Hata Modları

Korumalı bir dağıtımdan sonra ortaya çıkan belirtiler, nedenleri ve her biri için çalıştırılacak ilk komut.

Hidrasyon sunucu işaretlemesiyle eşleşmiyor

unpeek yalnızca istemci çıktı dizinlerini açar: `.next/static/chunks`, `dist/assets` ve `build/static/js`. `.next/server` altındaki sunucu paketleri hiç ayrıştırılmaz, dolayısıyla React sunucu render'ı dokunulmadan kalır.

Buna rağmen bir uyuşmazlık görürseniz korunan dizini `--out-dir` ile doğrulayın ve yolun proje köküne değil istemci çıktısına işaret ettiğini kontrol edin. Korumanın sunucu paketine ulaşmasının tek yolu yanlış bir `--out-dir` değeridir.

Terminal: CLI'yı istemci çıktısına yönlendir
# Açık hedef, pasif kalkan, deterministik tohum
unpeek protect --out-dir .next/static/chunks --passive --seed 0x7f4a2c

Üretim yığın izleri kısaltılmış semboller gösteriyor

Kaynak haritaları `.unpeek-maps/` içine taşınır ve `//# sourceMappingURL=` yorumu genel paketten silinir, böylece tarayıcının çözeceği bir adres kalmaz. Kasayı genel dizin yerine hata izleyicinize yükleyin.

  • Sentry veya Datadog yükleme adımını `.unpeek-maps/` dizinine yönlendirin, genel çıktıya asla.
  • `.unpeek-maps/` kaydını `.gitignore` içinde tutun. `unpeek init` bu satırı sizin için ekler.
  • Kasaya ihtiyaç yoksa ve haritalar tamamen silinecekse `--no-maps` kullanın.

Yavaş bir fonksiyon sıcak işaretlenmedi

`TRUE_HOT_60FPS` döngülerden, `requestAnimationFrame` ve `useFrame` içinden yayılır. Sığ UI bileşenleri ise yalnızca kendi doğrudan render karelerini sıcak tutar; iç olay işleyicileri (`onSubmit`, `handleSave`) soğuk korumaya alınır.

Profil döngü grafiği dışındaki bir yardımcıda kasa maliyeti gösteriyorsa işi algılanan bir kare döngüsünün arkasına taşıyın ya da `--min-string-length` değerini yükselterek kasaya daha az sabit sokun.