MESA Data · v0.1.0

Troubleshooting (TR)

v0.1.0 source: docs/SORUN_GIDERME.md

This guide has equivalent English and Turkish versions. The source sections behind this page are at the bottom.

Scope of this document#

MESA Data prepares reviewed Turkish legal sources through acquisition, canonicalization, validation and immutable release publication. Staging or HTTP 202 does not prove delivery into Core. Its package version and release tag are separate facts.

The original reference below preserves this page’s complete contract, commands or dated evidence in its source language. Test outcomes apply only within their stated date and conditions.

Verified sources
Source reference for this page

The sections of the upstream file that back this page, unchanged. Source section links open the appendix automatically.

Bu belge, MESA Legal Data kullanımı sırasında karşılaşabileceğiniz hata kodlarını ve çözüm yollarını içerir.


Veri Toplama Hataları#

HataSebepÇözüm
SOURCE_DISABLEDKaynak enabled: falseconfig/sources.yaml → ilgili kaynak → enabled: true yapın, sunucuyu yeniden başlatın
SOURCE_NOT_FOUNDSource ID sources.yaml'da tanımlı değilsources.yaml dosyasına kaynağı ekleyin
SOURCE_HOST_NOT_ALLOWEDURL alan adı allowed_hosts'ta yoksources.yaml → ilgili kaynak → allowed_hosts listesine alan adını ekleyin
SOURCE_CONTENT_TYPE_NOT_ALLOWEDDosyanın MIME türü izin listesinde yokallowed_content_types listesini kontrol edin; dosya formatını doğrulayın
SOURCE_FAMILY_NOT_ALLOWEDBelge ailesi bu kaynak için tanımlı değilfamilies listesini kontrol edin
FILE_TOO_LARGEDosya boyutu max_download_bytes sınırını aşıyorDaha küçük dosya kullanın veya sınırı artırın
URL scheme must be HTTPSHTTP kullanılmışURL'yi https:// ile başlatın
Access to private/local IP is forbiddenPrivate IP'ye erişim (SSRF koruması)Geçerli bir kamu IP'si olan URL kullanın
Non-standard port is forbidden443 dışı portStandart HTTPS portu (443) kullanın
Redirect loop detectedURL yönlendirme döngüsüne girdiURL'nin doğru olduğunu kontrol edin
Too many redirects3'ten fazla yönlendirmeNihai URL'yi doğrudan kullanın
HTTP connection failed after N retriesSunucu erişilemiyorİnternet bağlantınızı ve hedef sunucuyu kontrol edin
File is emptyBoş dosya yüklenmişGeçerli bir dosya yükleyin

Pipeline Hataları#

HataSebepÇözüm
TRANSPORT_VERIFICATION_FAILEDSHA-256 veya boyut uyuşmazlığıDosyayı yeniden yükleyin
PARSING_FAILEDDosya ayrıştırılamadıPDF/HTML formatını doğrulayın; bozuk dosya değilse yeniden yükleyin
SCHEMA_VALIDATION_FAILEDCanonical kayıt şema doğrulamasından geçemediKaynak dosyanın yapısını kontrol edin
Parsed text is emptyAyrıştırma sonucu boş metinDosyanın metin içerdiğini doğrulayın (taranmış PDF'ler OCR gerektirebilir)

Otomatik Veri Toplama (Harvest) Hataları#

HataSebepÇözüm
Harvest DB bulunamadıharvest.sqlite oluşturulmamışuv run mesa-data harvest init çalıştırın
retry_waitGeçici kaynak veya HTTP hatasıBackoff süresi dolunca runner otomatik yeniden dener
failedKalıcı pipeline hatası veya max attempt aşıldıuv run mesa-data harvest failures ile hata kodunu inceleyin
LOW_DISK_SPACESerbest disk alanı güvenlik eşiğinin altındaDisk alanı açmadan runner'ı başlatmayın
TARGET_REACHEDGlobal veya kaynak ham veri hedefi dolduNormal durdurma durumudur; hedefi artırabilir veya mevcudu işleyebilirsiniz
DISCOVERY_STRUCTURE_CHANGEDResmî kaynak sayfası beklenen formatta değilKaynak sayfasının yapısını kontrol edin; fail-closed kuralı gereği cursor ilerlemez
NO_PUBLICATIONO tarihte yayımlanmış resmî gazete/sayı yokNormal durumdur; sistem o günü tamamlandı sayıp sonraki tarihe geçer

İnceleme Hataları#

HataSebepÇözüm
Blocker issue engeliBlocker düzeyinde açık sorun varİlgili sorunun kaynağını çözün; gerekirse yeni dosya yükleyin
Kayıt pending değilZaten onaylanmış veya reddedilmiş kayıtYalnız pending kayıtlar onaylanabilir/reddedilebilir

Release Hataları#

HataSebepÇözüm
Release directory already existsAynı release ID ile daha önce build yapılmışFarklı bir release ID kullanın
Open blocker issues existÇözülmemiş blocker sorunlar varSorunlar ekranından blocker'ları tespit edip çözün
RELEASE_NOT_FOUNDRelease ID veritabanında yokDoğru release ID kullandığınızı kontrol edin
Cannot publish: must be 'verified'Henüz verify yapılmamışÖnce release verify çalıştırın
RELEASE_NOT_PUBLISHEDImport için release henüz yayınlanmamışÖnce release publish çalıştırın
RELEASE_REVOKEDİptal edilmiş release import edilmeye çalışılıyorYeni release oluşturun
RELEASE_STATE_CHANGEDImport sırasında release durumu değişmişİşlemi tekrar deneyin
already_imported (uyarı)Aynı release aynı manifest ile tekrar import edildiBu normal; veri tekrar yazılmaz
Manifest SHA-256 collisionAynı ID farklı manifestFarklı release ID kullanın

Kimlik Doğrulama ve Güvenlik#

HataSebepÇözüm
UNAUTHORIZEDAdmin token eksik veya yanlışMESA_DATA_WEB_ADMIN_TOKEN ortam değişkenini kontrol edin
NON_LOOPBACK_DISABLEDDış ağa açık ama token yokToken ayarlayın veya --host 127.0.0.1 kullanın
CSRF_HEADER_MISSINGYazma isteğinde gerekli header eksikTarayıcıdan normal kullanın; özel istemcide X-MESA-Requested-With: web-admin ekleyin
RATE_LIMIT_EXCEEDEDÇok fazla istek (dakikada 30 yazma / 300 okuma)Birkaç saniye bekleyip tekrar deneyin
AUTH_RATE_LIMIT_EXCEEDEDÇok fazla hatalı token denemesiToken'ı doğrulayıp bekleyin

Sistem Hataları#

HataSebepÇözüm
WRITE_LOCK_CONFLICTBaşka bir yazma işlemi çalışıyorÖnceki işlemin tamamlanmasını bekleyin
OPERATION_TYPE_NOT_SUPPORTEDDesteklenmeyen operation türüYalnız filtered_export, release_build, integrity_audit desteklenir
FILE_NOT_FOUNDDosya disk üzerinde bulunamadıuv run mesa-data doctor ile eksik dosyaları tespit edin
HASH_MISMATCHSHA-256 uyuşmazlığıuv run mesa-data audit çalıştırın; bozuk dosyayı tespit edip yedekten geri yükleyin
PATH_TRAVERSAL_DENIEDData root dışına erişim girişimiNormal kullanımda bu hata oluşmamalıdır; dosya yollarını kontrol edin
SYMLINK_REJECTEDSembolik bağlantı dosyaya erişimData root içinde symlink kullanmayın
Catalog database not foundcatalog.sqlite mevcut değiluv run mesa-data init ve uv run mesa-data migrate çalıştırın
No write permission to data rootData root'a yazma izni yokDizin izinlerini kontrol edin: chmod -R u+rw $DATA_ROOT
Backup file not foundGeri yükleme sırasında yedek dosya bulunamadıDosya yolunun doğru olduğunu kontrol edin

Genel ipuçları#

  1. Herhangi bir sorunla karşılaştığınızda önce uv run mesa-data doctor çalıştırın.
  2. Veritabanı sorunlarında uv run mesa-data backup ile yedek alın, ardından uv run mesa-data restore ile son çalışan yedeğe dönün.
  3. Hata mesajlarındaki büyük harfli kodları (örn. SOURCE_DISABLED) bu tabloda arayın.