Succede quasi sempre a ridosso di una scadenza: apri Desktop Telematico per inviare un F24 o controllare una CU e ti compare “A Java Exception has occurred”, oppure il programma resta bloccato sulla schermata di avvio. A quel punto la tentazione è disinstallare e reinstallare Java a caso, sperando che qualcosa si sblocchi.
Dalla versione 1.4.0 (rilasciata a giugno 2026), Desktop Telematico include una JVM 1.8 integrata nel pacchetto: non serve più installare Java separatamente, e anzi avere un’altra versione di Java sul sistema è spesso la causa dei problemi, non la soluzione. Nelle release precedenti, invece, il programma si appoggiava al Java già presente sul computer, ed è lì che nascevano la maggior parte dei blocchi in fase di avvio.
Perché un software del Fisco dipende ancora da Java
Desktop Telematico è, tecnicamente, un’applicazione desktop scritta in Java: gira su una macchina virtuale, non è codice nativo Windows o macOS. Questa scelta risale a un’epoca in cui Java garantiva la stessa applicazione su Windows, Mac e Linux senza riscriverla tre volte, ed è un’architettura che l’Agenzia delle Entrate non ha mai abbandonato, nonostante anni di lamentele da parte di commercialisti e CAF.
Il problema pratico è che Java, negli anni, ha cambiato spesso politica di sicurezza e compatibilità: una JVM troppo vecchia non regge le librerie più recenti del programma, una troppo nuova può non essere ancora certificata per quel modulo specifico. Da qui la scelta più recente dell’Agenzia: distribuire il proprio runtime già dentro il pacchetto, così l’utente non deve indovinare quale Java va bene.
La versione attuale: JVM inclusa, niente installazione a parte
Il pacchetto ufficiale, disponibile per Windows a 32 e 64 bit, macOS 64 bit e Linux 64 bit, si scarica dall’area riservata del sito dell’Agenzia delle Entrate previa autenticazione con SPID, CIE o CNS FONTE: telematici.agenziaentrate.gov.it/Main/Desktop.jsp. Ogni file di download è accompagnato da un hash SHA256 per verificarne l’integrità, un dettaglio che quasi nessuno controlla ma che in un’azienda con policy di sicurezza rigide può essere richiesto dall’IT.
Un dettaglio che molti sottovalutano: se sul computer è già installata una versione di Java per altri programmi (magari uno gestionale aziendale, o un vecchio strumento di studio), quella copia può interferire comunque con l’avvio di Desktop Telematico, anche se il programma non dovrebbe più averne bisogno. In pratica capita spesso che, dopo un aggiornamento del sistema operativo o di un altro software Java, riappaiano gli stessi errori che sembravano risolti da mesi.
Gli errori più comuni e da cosa dipendono davvero
Non tutti gli errori “Java” del Desktop Telematico hanno la stessa origine, ed è qui che si perde più tempo a cercare la soluzione sbagliata.
“A Java Exception has occurred” compare tipicamente per installazione incompleta, permessi utente insufficienti, oppure conflitto tra più versioni di Java residue nel sistema. Su Windows 11 in particolare, alcune installazioni datate vengono bloccate se non lanciate con privilegi di amministratore o in modalità compatibilità.
“Unable to read repository at …compositeContent.xml” è un errore diverso, meno legato alla versione di Java in sé e più al fatto che alcuni server dell’Agenzia storicamente rispondevano in HTTP e non HTTPS: le versioni moderne di Java bloccano di default le connessioni non cifrate per motivi di sicurezza, quindi il download degli aggiornamenti si interrompe. Va aggiunta un’eccezione manuale nel pannello di controllo Java, sezione Sicurezza, alla lista dei siti consentiti.
Il programma non parte proprio, schermata bianca o splash screen che si blocca: qui il sospetto numero uno sono le versioni multiple di Java installate contemporaneamente, magari una JDK recente accanto a un vecchio JRE 8 lasciato lì da anni. Il sistema operativo non sempre sceglie quella giusta, e il conflitto va risolto disinstallando tutto e lasciando solo quanto richiesto dalla versione del programma installata.
Questo passaggio dipende molto dal caso specifico: su una macchina aziendale con più software gestionali che condividono lo stesso runtime Java, la pulizia va fatta con cautela per non rompere altro.
Windows, Mac, Linux: le differenze contano
Sulle segnalazioni raccolte in rete, i problemi Java sono documentati soprattutto su Windows, semplicemente perché è l’ambiente più diffuso tra chi usa Desktop Telematico per lavoro. Su macOS le versioni supportate partono da build piuttosto datate e gli errori più frequenti riguardano i permessi di sicurezza di sistema (Gatekeeper che blocca l’app perché non riconosciuta). Su Linux, onestamente, le fonti sono più scarse: probabilmente perché lo usa una fetta di utenti più tecnica, abituata a gestire da sé conflitti di runtime, ma non è un dato che si può quantificare con certezza.
Come risolvere in pratica, in ordine
Prima di aprire un ticket o chiamare l’assistenza, vale la pena seguire questi passaggi nell’ordine indicato, perché ognuno esclude una causa diversa:
- Verificare la versione del Desktop Telematico installata: se è precedente alla 1.4.0, il primo consiglio è scaricare l’ultima release con JVM integrata dal sito ufficiale, sovrascrivendo l’installazione esistente (senza disinstallare, così l’ambiente di sicurezza con i certificati resta intatto).
- Controllare dal Pannello di controllo di Windows quante versioni di Java risultano installate e, se possibile, rimuovere quelle non necessarie ad altri programmi.
- Se l’errore riguarda l’aggiornamento dei moduli (non l’avvio del programma), aggiungere l’eccezione al sito dell’Agenzia nel pannello di sicurezza Java.
- Rilanciare l’installer come amministratore, eventualmente in modalità compatibilità per una versione precedente di Windows.
- Disattivare temporaneamente antivirus e firewall durante l’installazione, e verificare che non ci sia un proxy aziendale a bloccare le chiamate verso i server dell’Agenzia.
Un problema che si confonde spesso con quello di Java
Vale la pena distinguerlo: se il programma si avvia ma segnala che mancano moduli o che la procedura di controllo non è aggiornata, quasi sempre non è un problema di Java ma di aggiornamento dei moduli applicativi, che vanno scaricati periodicamente da dentro il programma stesso. Molti utenti, vedendo un errore generico, danno per scontato che sia sempre colpa del runtime Java e perdono tempo a reinstallarlo, quando basterebbe forzare l’aggiornamento dei moduli dal menu dell’applicazione.
Dato che parliamo di un software usato per adempimenti fiscali con scadenze precise, in caso di dubbi sulla versione corretta da installare o su errori persistenti conviene verificare direttamente sul portale dell’Agenzia delle Entrate o rivolgersi all’assistenza tecnica dedicata, soprattutto se si opera per conto di clienti come CAF o professionista.
Domande frequenti
Devo installare Java prima di usare Desktop Telematico? No, con le versioni recenti (dalla 1.4.0) la JVM è già inclusa nel pacchetto scaricato dal sito dell’Agenzia. Installare Java a parte non è necessario e in certi casi può creare conflitti con la versione integrata.
Perché mi compare “A Java Exception has occurred” all’avvio? Di solito per installazione incompleta, permessi utente mancanti o più versioni di Java installate insieme che confondono il sistema. Reinstallare sovrascrivendo la versione esistente, con privilegi di amministratore, risolve la maggior parte dei casi.
Che versione di Java serve se uso una versione vecchia del programma? Le versioni precedenti alla 1.4.0 si appoggiavano al Java di sistema, spesso JRE 8 o JDK 11 secondo le indicazioni circolate nel tempo. Il consiglio pratico resta aggiornare all’ultima versione ufficiale, che non richiede questa scelta.
Desktop Telematico funziona su Mac e Linux allo stesso modo di Windows? Sì, esistono pacchetti dedicati per macOS 64 bit e Linux 64 bit, scaricabili dallo stesso portale. Gli errori più frequenti su Mac riguardano i permessi di sicurezza del sistema operativo, non la versione di Java.
Dove scarico l’ultima versione del Desktop Telematico? Dall’area riservata del sito dell’Agenzia delle Entrate, autenticandosi con SPID, CIE o credenziali CNS, nella sezione dedicata ai servizi telematici.
Con la JVM ormai integrata nel pacchetto, la parte più fastidiosa di Desktop Telematico dovrebbe progressivamente sparire da sola. Nel frattempo, però, restano in giro migliaia di installazioni vecchie e guide non aggiornate che consigliano ancora di installare Java a mano: è lì che si annida la maggior parte delle segnalazioni che si leggono ancora oggi nei forum.
Giornalista e analista, scrive di economia italiana, innovazione e imprese. Appassionato di tecnologia e finanza, racconta il presente e il futuro delle aziende che fanno muovere il Paese.
