e-Defter Berat İmzalarken 'Bellek Yetersiz' (Java OutOfMemory) Hatası ve Mühür Performansı

Hacimli ticari faaliyet yürüten şirketlerde aylık yevmiye ve kebir kayıtları yüz binlerce satıra ve yüzlerce megabaytlık XML dosyalarına ulaşabilmektedir. GİB e-Defter uygulaması veya muhasebe yazılımları üzerinden bu devasa XML dosyaları Mali Mühür ile imzalanmaya çalışıldığında en sık karşılaşılan sistem çökmesi Java Heap Space (java.lang.OutOfMemoryError) hatasıdır (özellikle ay sonlarında benzer krizlerle karşılaşmamak için e-defter berat gününde mali mühür çalışmazsa çözüm rehberimizi inceleyebilirsiniz). Bilgisayarınızda 32 GB RAM olsa dahi standart Java ayarları bu devasa veriyi işleyemez ve berat imzalama işlemi yarıda kalır. Bu teknik makalede bellek hatasının kök nedenini ve Java bellek artırma parametrelerini paylaşıyoruz.

1. Hatanın Nedeni: Varsayılan Java Bellek Sınırı (Default Heap Size)

Java Sanal Makinesi (JVM), başlatılırken işletim sisteminden kullanabileceği maksimum RAM miktarını sınırlar. Eğer yazılım bir parametre ile başlatılmamışsa, sistemde ne kadar RAM olursa olsun Java uygulamaya yalnızca 512 MB veya 1024 MB bellek ayırır. Yüz bin satırlık bir e-defter XML ağacı DOM nesnesine dönüştürülürken bu sınır saniyeler içinde aşılır ve sistem kilitlenir.

2. Çözüm: Java Bellek Parametrelerinin (Xmx) Artırılması

GİB e-Defter uygulamasının masaüstü başlatıcısını (edefter.bat veya kısayol) düzenleyerek (ayrıca beratların güvenli kopyalanması için e-defter ikincil kopyaların GİB sistemine yüklenmesi kılavuzumuzdan yararlanabilirsiniz) Java'ya daha fazla RAM tahsis edilmelidir:

1. e-Defter programının kurulu olduğu klasörü açın (Genellikle C:\edefter).
2. Programı başlatan edefter.bat dosyasını sağ tıklayıp Not Defteri ile açın.
3. Komut satırındaki parametreyi şu şekilde güncelleyin:

   java -Xms1024m -Xmx4096m -jar edefter.jar

4. Burada -Xmx4096m ifadesi, uygulamanın 4 GB'a kadar RAM kullanmasına izin verir. Eğer bilgisayarınızda 16 GB veya daha fazla RAM varsa bu değeri -Xmx8192m (8 GB) yapabilirsiniz.

3. 64-bit Java Kullanımının Önemi

Eğer bilgisayarınızda 32-bit Java kurulu ise, mimari kısıt sebebiyle Java'ya asla 1.5 GB'tan fazla RAM veremezsiniz. 4 GB ve üzeri bellek atayabilmek için sisteminizde kesinlikle 64-bit Java Runtime Environment (JRE x64) kurulu olmalıdır.

4. XML Dosya Parçalama (Defter Bölme)

GİB mevzuatına göre bir e-defter XML dosyasının boyutu 200 MB'ı aşmamalıdır. Muhasebe programınızdan defter oluştururken 'Aylık Defteri Parçala / Günlük veya On Günlük Böl' seçeneğini kullanarak dosyaları daha küçük parçalar halinde üretmek hem imzalama hızını artırır hem de bellek çökmelerini engeller.

5. Büyük Defter Dosyalarında Disk İ/O ve Performans Optimizasyonu

RAM bellek sınırının yanı sıra e-defter imzalama hızını doğrudan etkileyen faktör sabit disk okuma/yazma hızıdır:

• GİB e-Defter uygulamasının çalıştığı dizin ve XML dosyalarının bulunduğu klasör yüksek hızlı NVMe SSD disklerde barındırılmalıdır.
• Antivirüs yazılımlarının e-defter XML klasöründe 'Gerçek Zamanlı Dosya Taraması' yapması imzalama süresini 5 kat yavaşlatabilir; klasöre antivirüs istisnası eklenmelidir.
• İmzalama esnasında bilgisayarda açık olan ağır programlar (CAD, video render vb.) kapatılmalı, tüm CPU gücü Java işlemine ayrılmalıdır.

6. GİB e-Defter Test Ortamında Doğrulama

Bellek parametrelerini güncelledikten sonra yevmiye ve kebir beratlarını GİB sistemine göndermeden önce GİB Defter Test Aracında XML şema kontrolünden geçirerek Schematron Valid onayını aldığınızdan emin olun.

Sonuç

Java bellek ayarlarını doğru yapılandırarak ve defter boyutlarını optimize ederek yüz binlerce satırlık defter beratlarınızı mali mühür ile dakikalar içinde sorunsuz mühürleyebilirsiniz.