Problema di caricamento documenti OnlyOffice su Nextcloud (Schermata vuota o Caricamento infinito)

Descrizione del problema

Potrebbe verificarsi l'impossibilità di aprire documenti (PDF, fogli di calcolo XLSX, documenti testuali) tramite l'integrazione di OnlyOffice all'interno di Nextcloud. Cliccando sul file, l'interfaccia si apre ma rimane bloccata su una schermata di caricamento infinita o su una pagina grigia vuota. Nessun messaggio di errore esplicito viene mostrato a video.

Causa principale

Se i server (Nextcloud e il Document Server di OnlyOffice) comunicano correttamente tra loro (cosa verificabile nelle impostazioni di amministrazione), il problema è quasi sempre lato client (browser dell'utente).

Poiché OnlyOffice viene caricato all'interno di Nextcloud tramite un iframe (che spesso punta a un dominio diverso da quello di Nextcloud), i sistemi di sicurezza del browser possono interpretare questa azione come un tentativo di tracciamento o una violazione di sicurezza (CORS), bloccando l'esecuzione degli script essenziali per l'avvio dell'editor.

I colpevoli più comuni sono:

• AdBlocker o estensioni per la privacy (es. uBlock Origin, AdBlock Plus, Ghostery).

• Filtri anti-tracciamento integrati nel browser (es. lo scudo di Brave, la protezione antitracciamento di Firefox).

• Blocco dei cookie di terze parti (impostazione sempre più frequente sui browser moderni).

Diagnosi rapida (La prova del nove)

Per confermare che il problema sia causato dal browser e non dal server, è possibile effettuare questo test:

1. Aprire una finestra del browser in Modalità Navigazione in Incognito / Anonima.

2. Effettuare l'accesso a Nextcloud.

3. Provare ad aprire il documento.

Risultato: Se il file si apre correttamente in modalità incognito, il problema è garantito al 100% lato browser/estensioni, poiché la navigazione anonima disattiva di default gran parte degli script di blocco e svuota la cache.

Soluzione finale

Eseguire questi tre passaggi sul proprio browser standard:

1. Disattivare i sistemi di blocco per il dominio in uso

• Cliccare sull'icona delle estensioni di blocco pubblicità (AdBlock) e disattivarle specificamente per la pagina di Nextcloud (aggiungere alle eccezioni).

• Se si utilizza Brave, disattivare lo "Scudo" per il dominio del cloud.

• Se si utilizza Firefox, cliccare sull'icona dello scudo a sinistra della barra degli indirizzi e disattivare la "Protezione antitracciamento avanzata" per il sito.

2. Consentire i Cookie di Terze Parti

• L'editor ha bisogno di scrivere cookie di sessione per funzionare. Cliccare sull'icona del lucchetto nella barra degli indirizzi (accanto all'URL di Nextcloud) e assicurarsi che i cookie di terze parti o il tracciamento cross-site siano abilitati.

3. Svuotare la cache (Hard Refresh)

• Una volta modificate le impostazioni, forzare il browser a riscaricare la pagina premendo Ctrl + F5 (o Ctrl + Shift + R; su Mac Cmd + Shift + R).