UDF Editör son güncellemeyle (sürüm 5.2.0) Windows 11'de açılmamaya başladı, log dosyasında 'NullPointerException' veriyor, uyumluluk modunda çalıştırmak işe yarar mı?

Merhaba, UYAP Doküman Editörü'nün (UDF) 5.2.0 güncellemesi sonrasında Windows 11 ortamında karşılaştığınız açılış çökmesi ve log kayıtlarında görülen java.lang.NullPointerException hatası, adliye personeli ve avukat meslektaşlarımızın yeni sürüme geçişte en sık raporladığı teknik uyuşmazlıklardan biridir.

Öncelikle sorunuzun ilk kısmına kesin bir açıklık getirelim: UDF Editör'ü Windows uyumluluk modunda (Windows 8 veya 7) çalıştırmak sorunu kesinlikle ÇÖZMEZ. Windows uyumluluk modu, doğrudan yerel Win32 API'leri üzerinden işletim sistemi çekirdeğiyle konuşan derlenmiş C/C++ programlarının sistem çağrılarını yönlendirmek için tasarlanmıştır. UYAP Doküman Editörü ise Java bytecode olarak derlenen ve işletim sisteminden tamamen soyutlanmış bir Java Sanal Makinesi (JVM) katmanı üzerinde çalışan bir uygulamadır. JVM'in bellekte bir nesne referansını bulamamasından kaynaklanan NullPointerException hatası mantıksal bir Java çalışma zamanı istisnasıdır; işletim sistemi uyumluluk katmanı bu istisnaya müdahale edemez.

UDF 5.2.0 Sürümünde Windows 11 Altında NullPointerException Hatasının Kök Nedenleri:

• Eski Kullanıcı Profili ve XML Şema Çakışması: UDF Editör'ün önceki sürümleri (örneğin 4.x veya 5.1.x), kullanıcı tercihleri, son açılan dosyalar, pencere boyutları ve araç çubuğu düzenlerini %USERPROFILE%\.uyap dizininde saklar. 5.2.0 sürümü güncellendiğinde, arayüz ilklendirme motoru eski XML yapılandırma dosyasındaki bazı anahtarları aramakta; yeni eklenen parametreleri bulamayınca null referans döndürerek grafik arayüz (Swing/AWT) henüz çizilmeden çökmektedir.
• DirectDraw / Direct3D ve Windows 11 Font Haritalama Çakışması: Windows 11'in yeni DirectWrite ve modern Segoe UI değişken font altyapısı, Java Swing'in metin işleme kütüphanesi (sun.font.FontDesignMetrics) ile donanım hızlandırma modunda çakışarak null işaretçi üretmektedir.
• Java Sürüm ve Mimari Çakışması: Bilgisayarınızda hem 32-bit eski Java sürümleri hem de 64-bit Java bulunuyorsa ve ortam değişkenlerindeki (JAVA_HOME / PATH) göstergeler hatalıysa, 5.2.0 sürümünün ihtiyaç duyduğu kütüphaneler yerine eski kütüphaneler yüklenmeye çalışılır.

Sorunu Kalıcı Olarak Çözmek İçin Uygulanacak Adımlar:

1. UYAP Kullanıcı Profilini ve Önbelleğini Sıfırlayın (En Etkili Çözüm)

• Çalışmakta olan tüm Java ve UDF süreçlerini Görev Yöneticisi'nden (Ctrl + Shift + Esc) kapatın.
• Klavyenizden Windows + R tuşlarına basarak Çalıştır penceresini açın ve %USERPROFILE% yazıp Enter'a basın (Kullanıcı ana klasörünüz açılacaktır).
• Burada yer alan .uyap isimli klasörü bulun. Bu klasörü doğrudan silin veya adını .uyap_yedek olarak değiştirin.
• Aynı şekilde C:\Users\KullaniciAdiniz\AppData\Roaming\UDF veya Local\Temp altındaki geçici UDF dosyalarını temizleyin.
• UDF Editör'ü yeniden başlattığınızda sistem sıfır, temiz ve güncel şemaya sahip bir .uyap profili oluşturacak ve açılış hatası %90 oranında çözülecektir.

2. Java 2D Donanım Hızlandırmasını Devre Dışı Bırakın

Eğer profil sıfırlamaya rağmen çökme sürüyorsa, grafik kartı çakışmasını engellemek için başlatıcı parametrelerini düzenleyin:

• UDF Editör'ün kurulu olduğu dizine gidin (Varsayılan olarak C:\Program Files\UYAP\Uyap Dokuman Editoru).
• Klasör içerisindeki launcher.cfg veya UyapDokumanEditoru.ini dosyasını Not Defteri ile yönetici olarak açın.
• Java çalışma zamanı parametreleri (JVM Arguments) satırına şu bayrakları ekleyin:
  -Dsun.java2d.d3d=false -Dsun.java2d.noddraw=true -Dfile.encoding=UTF-8
• Bu parametreler Direct3D donanım hızlandırmasını kapatarak Java'nın Windows 11 pencerelerini kararlı yazılımsal render (GDI) motoruyla çizmesini sağlar.

3. Windows Font Önbelleğini Temizleyin

Başlat menüsünden Hizmetler (services.msc) uygulamasını açın, Windows Presentation Foundation Yazı Tipi Önbelleği hizmetini durdurun. Ardından C:\Windows\ServiceProfiles\LocalService\AppData\Local dizinindeki FontCache*.dat ve FNTCACHE.DAT dosyalarını silerek bilgisayarınızı yeniden başlatın.

Bu üç adımı tamamladıktan sonra UDF Editör 5.2.0 sürümü Windows 11 üzerinde kusursuz bir şekilde açılacaktır.