dokümanlar / troubleshooting

Sorun giderme

En yaygın kurulum, CSS, veritabanı ve yapay zekâ hatalarını giderin.

Sağlık uç noktası başarısız oluyor

/api/pagiera/health adresini açın ve ilk başarısız bağımlılığı ele alın. Ortam değişkenlerinin Next.js sunucu sürecinde kullanılabilir olduğunu doğrulayın, ardından PostgreSQL ve Redis'i birbirinden bağımsız test edin.

Düzenleyicide stiller görünmüyor

pagiera/full.css dosyasını kendi stil dosyanızdan önce içe aktarın. CSS @import kuralları normal stil kurallarından önce gelmelidir. Kök stil dosyasını değiştirdikten sonra geliştirme sunucusunu yeniden başlatın.

getEditorBootstrap bir işlev değil

Uygulamanız ve oluşturulan kilit dosyası farklı paket sürümlerini çözümlüyor olabilir. Kurulu pagiera sürümünü inceleyin, bağımlılıkları yeniden yükleyin ve Next.js'i yeniden başlatın.

Yapay zekâ ile üretim başarısız oluyor

OPENROUTER_API_KEY değerinin sunucuda bulunduğunu ve OPENROUTER_MODEL değerinin hesabın erişebildiği bir modeli adlandırdığını doğrulayın. Yapay zekâ isteğe bağlıdır; temel düzenleyiciyi teşhis ederken yapılandırmasını kaldırın.

Yayımlanan API verisi HTML'de eksik

Yayımlanmış belgeyi istek bağlamıyla birlikte sunucuda yükleyin. Rota parametrelerinin ve sorgu değerlerinin Request bloklarındaki yer tutucularla eşleştiğini doğrulayın. Yalnızca istemci etkileşimleri bağlanmış tarayıcı görünümünü değil, ham HTML yanıtını inceleyin.

Sayfa kaydediliyor ancak herkese açık görünüm değişmiyor

Kaydetme yalnızca taslağı değiştirir. Taslağı doğrulamak için önizlemeyi açın, ardından yayımlayın. Herkese açık sayfa eski kalıyorsa Redis bağlantısını ve önbellek geçersiz kılmayı kontrol edin.